Canva

获得设计导入工作

开发环境

GET

/rest/v1/imports/{jobId}

获取设计导入作业的状态和结果，包括导入的设计。

此 API 目前以预览版形式提供。请注意以下事项：

可能会有未公布的重大变化。

对预览 API 的任何重大更改都不会产生新的API 版本。

使用预览 API 的公共集成将不会通过审核流程，并且无法向所有 Canva 用户提供。

获取使用创建设计导入作业 API创建的设计导入作业的状态和结果。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'http://dev-cn.your-api-server.com/rest/v1/imports/' \
--header 'Authorization: Bearer {token}'

响应示例

{
  "job_id": "f81b26fd-a33d-4c2d-9e8c-4a7aca798b17",
  "status": {
    "state": "success"
  },
  "designs": [
    {
      "id": "DAFVztcvd9z",
      "title": "My summer holiday",
      "owner": {
        "user_id": "auDAbliZ2rQNNOsUl5OLu",
        "team_id": "Oi2RJILTrKk0KRhRUZozX"
      },
      "thumbnail": {
        "width": 595,
        "height": 335,
        "url": "https://document-export.canva.com/Vczz9/zF9vzVtdADc/2/thumbnail/0001.png?<query-string>"
      },
      "urls": {
        "edit_url": "https://www.canva.com/api/design/{token}/edit",
        "view_url": "https://www.canva.com/api/design/{token}/view"
      }
    }
  ]
}

请求参数

Path 参数

jobId

string

必需

设计导入作业 ID。

Header 参数

Authorization

string

必需

示例值:

Bearer {token}

返回响应

🟢200成功

application/json

Body

job_id

string

必需

设计导入作业 ID。

status

object

设计导入的状态。

必需

state

string

必需

设计导入作业的状态。可以是以下之一： failed importing success

designs

array [object {5}]

必需

从外部文件导入的设计列表。通常包含一个项目。包含大量页面或资产的导入将拆分为多个设计。

string

可选

title

string

可选

owner

object

可选

thumbnail

object

可选

urls

object

可选

修改于 2024-06-26 09:53:29

创建设计导入作业

概述