创建设计导入作业

创建一个异步作业来导入在另一个应用程序中创建的设计。

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

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

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

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

启动新作业，将外部文件作为新设计导入 Canva。此端点的请求格式包含application/octet-stream字节主体，并使用标头附加有关导入的信息Import-Metadata。

支持的格式：PDF( .pdf)、Adobe Illustrator( .ai)、Adobe Photoshop( .psd)、Microsoft Word( .docx)、Microsoft Powerpoint( .pptx)、Microsoft Excel( .xls、.xlsx)、OpenOffice Draw( .odg)、OpenOffice Presentation( .odp)、OpenOffice Sheets( .ods)、OpenOffice Text( .odt)。

您可以使用获取设计导入作业 API检查状态并获取使用此 API 创建的导入作业的结果。

有关上传格式和要求，请参阅 Canva 帮助 — 上传格式和要求。

curl --location --request POST 'http://dev-cn.your-api-server.com/rest/v1/imports' \ --header 'Authorization: Bearer {token}' \ --header 'Import-Metadata: { "title_base64": "TXkgQXdlc29tZSBEZXNpZ24g8J+YjQ==" }' \ --header 'Content-Type: application/octet-stream' \ --data-raw '@/path/to/file'

请求参数

Header 参数

Authorization

string

必需

以令牌的形式提供凭证来验证请求Bearer。

示例值:

Bearer {token}

Content-Type

string

必需

指示请求中发送的信息的媒体类型。必须设置为application/octet-stream。

示例值:

application/octet-stream

Import-Metadata

string

必需

导入设计时作为标题参数包含的有关设计的元数据。

示例值:

{ "title_base64": "TXkgQXdlc29tZSBEZXNpZ24g8J+YjQ==" }

Body 参数text/plain

示例

创建设计导入作业

请求参数

返回响应