API v1

查询素材状态

GET/v1/assets/{asset_id}

需要 service.use 权限,仅可查询本团队素材。

查看 Markdown
  • 在请求头 Authorization: Bearer 后面放 API 密钥;API 密钥需要 service.use 权限。
  • 只能查询本团队的素材;其他标识一律返回 asset_not_found。
  • active 时返回尺寸、大小和摘要;unavailable 时查看 failure_reason。

请求头

#Authorizationstring必填

Bearer 加一个空格和 API 密钥。缺失或无效时返回 401 authentication_failed。

#X-Request-IDstring

你自己的请求标识。无效或重复的值会被替换,最终值在响应头 X-Request-ID 返回。

路径参数

#asset_idstring必填

平台素材标识,归属范围为认证团队。

长度36–36格式ast- 加 32 位十六进制

返回HTTP 200

当前素材状态与可用的安全元数据。

返回「素材对象」,字段说明见该页。

响应头

#X-Request-IDstring必填

本次请求的标识:你提供的有效值,或替换后的值。

#Cache-Controlstring必填

响应不应被缓存。

状态码

每个 error.code 的处理办法见「错误码」。

状态码说明与 error.code
200当前素材状态与可用的安全元数据。
响应头Cache-Control
400请求无效。
401API 密钥缺失或无效。
响应头WWW-Authenticate
403当前 API Key 缺少 service.use 权限。
404本团队没有可见素材;未知、已删除及其他团队标识返回相同结果。
503服务暂时不可用。