Canva
  1. 资产
Canva
  • 验证
    • 概述
    • 生成访问令牌
      POST
    • 审视访问令牌
      POST
    • 撤销令牌
      POST
  • 资产
    • 概述
    • 创建资产上传作业
      POST
    • 获取资产上传作业
      GET
    • 获取资产
      GET
    • 更新资产
      PATCH
    • 删除资产
      DELETE
  • 自动填充
    • 概述
    • 创建设计自动填充作业
      POST
    • 获取设计自动填充工作
      GET
  • 品牌模板
    • 概述
    • 获取品牌模版
      GET
    • 获取品牌模板数据集
      GET
    • 列出品牌模板
      GET
  • 评论
    • 概述
    • 创建评论
      POST
    • 获取评论
      GET
    • 创建回复
      POST
  • 设计
    • 概述
    • 创建设计
      POST
    • 列表设计
      GET
    • 获取设计
      GET
  • 设计导入
    • 概述
    • 创建设计导入作业
    • 获得设计导入工作
  • 导出
    • 概述
    • 创建设计导出作业
    • 获得设计出口工作
  • 文件夹
    • 概述
    • 创建文件夹
    • 获取文件夹
    • 更新文件夹
    • 删除文件夹
    • 列出文件夹项目
    • 移动文件夹项目
  • 用户
    • 概述
    • 获取当前用户的详细信息
    • 获取当前用户的个人资料
  • webhook
    • 获取 webhook 的公钥
  1. 资产

更新资产

开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
PATCH
/rest/v1/assets/{assetId}
更新用户项目中资产的元数据。
您可以通过指定资产来更新其名称和标签assetId。更新标签将替换资产的所有现有标签。
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request PATCH 'http://dev-cn.your-api-server.com/rest/v1/assets/' \
--header 'Authorization: Bearer {token}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "name": "My Awesome Upload",
  "tags": [
    "image",
    "holiday",
    "best day ever"
  ]
}'
响应示例响应示例
{
  "asset": {
    "id": "Msd59349ff",
    "name": "My Awesome Upload",
    "tags": [
      "image",
      "holiday",
      "best day ever"
    ],
    "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 参数
assetId
string 
资产的 ID。
必需
Header 参数
Authorization
string 
必需
示例值:
Bearer {token}
Content-Type
string 
必需
示例值:
application/json
Body 参数application/json
name
string 
可选
资产的名称。此名称显示在 Canva UI 中。当此字段未定义时,不会更新任何内容。最大长度为 50 个字符。
tags
array[string]
可选
资产的替换标签。当此字段未定义时,不会更新任何内容。最大长度为 50 个标签。每个标签的最大长度为 50 个字符。
示例

返回响应

🟢200成功
application/json
Body
asset
object 
必需
id
string 
资产的 ID。
必需
name
string 
资产的名称。
必需
tags
array[string]
必需
附加到资产的面向用户的标签。用户可以将这些标签添加到他们上传的资产中,并且可以通过搜索这些标签在 Canva UI 中搜索他们上传的资产。有关用户如何使用标签的信息,请参阅 Canva 帮助中心的资产标签页面。
created_at
integer 
必需
当资产添加到 Canva 时,以 Unix 时间戳 (自 Unix 纪元以来的秒数) 表示。
updated_at
integer 
必需
资产在 Canva 中最后更新的时间,以 Unix 时间戳(自 Unix 纪元以来的秒数)表示。
thumbnail
object 
代表对象的缩略图。
必需
修改于 2024-06-26 09:07:50
上一页
获取资产
下一页
删除资产
Built with