通過簽名下載資產

從原始碼生成 GET /assets/{asset_id}/content 的鑑權、欄位、響應、錯誤與安全呼叫參考。

公開測試API v1 · 1.4.0最後核實 2026-09-15

本頁目錄

操作

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`	短期有效的儲存下載地址。

允許文件互動分析

不收集搜尋字詞、程式碼或自由文字。此開關僅控制文件互動事件。隱私權政策