Canva

更新文件夹

开发环境

PATCH

/rest/v1/folders/{folderId}

更新文件夹的元数据。

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

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

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

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

使用更新文件夹的详细信息folderID。目前，您只能更新文件夹的名称。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request PATCH '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"
}'

响应示例

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

请求参数

Path 参数

folderId

string

文件夹 ID。

必需

Header 参数

Authorization

string

必需

示例值:

Bearer {token}

Content-Type

string

必需

示例值:

application/json

Body 参数application/json

name

string

必需

文件夹名称，如 Canva UI 中所示。

示例

返回响应

🟢200成功

application/json

Body

folder

object

必需

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

string

文件夹 ID。

必需

name

string

文件夹名称。

必需

created_at

integer

必需

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

updated_at

integer

必需

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

thumbnail

object

代表对象的缩略图。

必需

修改于 2024-06-27 05:47:25

获取文件夹

删除文件夹