通过签名下载资产

从源码生成 GET /assets/{asset_id}/content 的鉴权、字段、响应、错误与安全调用参考。

公开测试API v1 · 1.3.0最后核实 2026-08-30

本页目录

操作

GET /assets/{asset_id}/content

operationId: download_asset_v1_assets__asset_id__content_get

使用 Asset 响应给出的完整签名 URL 下载字节，无需也不建议携带 Bearer 头。不要自行构造签名，不转发凭据给存储。按交付模式返回文件或 302 跳转。过期或无效签名表现为 NOT_FOUND，应通过 GET /assets/{asset_id} 刷新信息。

使用返回的完整签名 URL，不携带 Bearer Key。

此操作不启动付费生成，其他状态变化见上文说明。

参数	位置	类型	必填	约束 / 默认值	含义
`asset_id`	`path`	`string`	是	`format`: `uuid`	所属公共资源 UUID；任务、资产、文件 ID 不能互换。
`expires`	`query`	`integer`	是	`exclusiveMinimum`: `0`	使用返回的签名 URL 中的值，不自行构造或记录。
`signature`	`query`	`string`	是	`minLength`: `64`; `maxLength`: `64`	使用返回的签名 URL 中的值，不自行构造或记录。

HTTP	正文	含义
`200`	`string`	资产字节，Content-Type 由具体资产决定。
`302`	—	重定向到短期存储地址，不转发凭据。
`400`	APIErrorEnvelope	输入错误，修正请求后再尝试。
`404`	APIErrorEnvelope	资源不可用、不属于当前用户，或签名无效/过期。
`500`	APIErrorEnvelope	内部错误，保留任务 ID 和幂等键，仅标记可重试时重试。
`503`	APIErrorEnvelope	服务或供应商不可用，仅 error.retryable 为 true 时重试。

HTTP	响应头	类型	含义
`302`	`Location`	`string`	短期有效的存储下载地址。

允许文档使用分析

不收集搜索词、代码或自由文本。此开关只控制文档交互事件；站点通用分析仍遵循隐私政策。隐私政策