创建设计 - Canva

创建 Canva 设计。

创建新的 Canva 设计。要创建新设计，您可以：

使用预设的设计类型。

设置自定义设计的高度和宽度尺寸。

此外，您还可以提供asset_id用户项目中资产的列表以添加到新设计中。要列出用户项目中文件夹中的资产，请使用列出文件夹项 API。

curl --location --request POST 'http://dev-cn.your-api-server.com/rest/v1/designs' \ --header 'Authorization: Bearer {token}' \ --header 'Content-Type: application/json' \ --data-raw '{ "design_type": { "type": "preset", "name": "doc" }, "asset_id": "Msd59349ff", "title": "My Holiday Presentation" }'

{ "design": { "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" } } }

请求参数

Header 参数

Authorization

string

必需

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

示例值:

Bearer {token}

Content-Type

string

必需

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

示例值:

application/json

Body 参数application/json

design_type

object

所需的设计类型。

可选

type

string

必需

name

string

必需

asset_id

string

可选

插入到创建的设计中的资产的 ID。

title

string

可选

设计的名称。必须少于 256 个字符。

示例

返回响应

🟢200成功

application/json

Body

design

object

必需

设计对象，包含有关设计的元数据。

string

设计 ID。

必需

title

string

设计标题。

必需

owner

object

必需

用户的元数据，包括用户 ID 和团队 ID。

thumbnail

object

代表对象的缩略图。

必需

urls

object

必需

用于查看或编辑设计的一组临时 URL。