创建资产上传作业

创建一个异步作业来上传资产。

启动一项新作业，将资产上传到用户的内容库。

此端点的请求格式为application/octet-stream字节主体。使用标头附加有关上传的信息Asset-Upload-Metadata。

您可以使用获取资产上传作业 API检查状态并获取使用此 API 创建的资产上传作业的结果。

curl --location --request POST 'http://dev-cn.your-api-server.com/rest/v1/asset-uploads' \ --header 'Authorization: Bearer {token}' \ --header 'Asset-Upload-Metadata: { "name_base64": "TXkgQXdlc29tZSBVcGxvYWQg8J+agA==" }' \ --header 'Content-Type: application/octet-stream' \ --data-raw '@/path/to/file'

{ "job": { "id": "Msd59349ff", "status": "success", "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>" } } } }

请求参数

Header 参数

Authorization

string

必需

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

示例值:

Bearer {token}

Content-Type

string

必需

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

示例值:

application/octet-stream

Asset-Upload-Metadata

string

必需

正在上传的资产的元数据。

示例值:

{ "name_base64": "TXkgQXdlc29tZSBVcGxvYWQg8J+agA==" }

Body 参数text/plain

示例

application/json

Body

job

object

必需

string

必需

资产上传作业的ID。

status

string

必需

资产上传作业的状态。可以是以下之一： failed in_progress success

asset

object

必需

资产对象，包含有关资产的元数据。

创建资产上传作业

请求参数

返回响应