创建文件夹 - Canva

在用户的项目中创建一个新文件夹。

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

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

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

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

在 Canva 用户项目的顶层创建一个文件夹（使用 ID root），或在另一个文件夹中创建一个文件夹（使用父文件夹的 ID）。成功创建文件夹后，端点将返回其文件夹 ID 以及其他信息。

curl --location --request POST 'http://dev-cn.your-api-server.com/rest/v1/folders' \ --header 'Authorization: Bearer {token}' \ --header 'Content-Type: application/json' \ --data-raw '{ "name": "My awesome holiday", "parent_folder_id": "FAF2lZtloor" }'

{ "folder": { "id": "FAF2lZtloor", "name": "My awesome holiday", "created_at": 1377396000, "updated_at": 1692928800, "thumbnail": { "width": 595, "height": 335, "url": "https://document-export.canva.com/Vczz9/zF9vzVtdADc/2/thumbnail/0001.png?<query-string>" } } }

请求参数

Header 参数

Authorization

string

必需

示例值:

Bearer {token}

Content-Type

string

必需

示例值:

application/json

Body 参数application/json

name

string

必需

文件夹的名称。必须少于 256 个字符。

parent_folder_id

string

必需

父文件夹的文件夹 ID。要在用户项目的顶层创建新文件夹，请使用 ID root。

示例

返回响应

🟢200成功

application/json

Body

folder

object

必需

文件夹对象，包含有关文件夹的元数据。

string

文件夹 ID。

必需

name

string

文件夹名称。

必需

created_at

integer

必需

文件夹创建的时间，以 Unix 时间戳 (自 Unix 纪元以来的秒数为单位) 表示。

updated_at

integer

必需

文件夹最后更新的时间，以 Unix 时间戳 (Unix 纪元以来的秒数) 表示。

thumbnail

object

代表对象的缩略图。

必需