署名付き素材をダウンロード
GET /assets/{asset_id}/contentの認証、フィールド、応答、エラー、安全な運用をソースから生成した参考資料です。
このページの目次
操作
GET /assets/{asset_id}/content
operationId: download_asset_v1_assets__asset_id__content_get
素材の応答に含まれる完全な署名付きURLからバイトを取得します。Bearerヘッダーは不要で、付けるべきではありません。署名を自作したりストレージへ認証情報を転送したりしないでください。配信方法によりバイトまたはHTTP 302が返ります。期限切れ・無効な署名はNOT_FOUNDとなるため、GET /assets/{asset_id}で情報を更新します。
認証と副作用
返された署名付きURLを完全な形で使い、Bearerキーを付けないでください。
有料生成は始めません。ほかの状態変更は上記を確認してください。
パラメータ
| パラメータ | 位置 | 型 | 必須 | 制約／既定値 | 説明 |
|---|---|---|---|---|---|
asset_id |
path |
string |
はい | format: uuid |
Owned public resource UUID; task, asset, and file IDs are not interchangeable. |
expires |
query |
integer |
はい | exclusiveMinimum: 0 |
Use the value in the returned signed URL; never invent or log it. |
signature |
query |
string |
はい | minLength: 64; maxLength: 64 |
Use the value in the returned signed URL; never invent or log it. |
応答
| HTTP | 本文 | 説明 |
|---|---|---|
200 |
string |
Asset bytes; Content-Type depends on the asset. |
302 |
— | Redirect to short-lived storage URL; do not forward credentials. |
400 |
APIErrorEnvelope | Invalid input; correct the request before retrying. |
404 |
APIErrorEnvelope | Resource is unavailable, not owned, or its signature is invalid/expired. |
500 |
APIErrorEnvelope | Internal failure; preserve the task/key and retry only when marked retryable. |
503 |
APIErrorEnvelope | Service/provider unavailable; retry only when error.retryable is true. |
応答ヘッダー
| HTTP | ヘッダー | 型 | 説明 |
|---|---|---|---|
302 |
Location |
string |
Short-lived storage download URL. |
関連ガイド
この記事は役に立ちましたか？
検索語句、コード、自由記述は収集しません。この設定はドキュメントの操作イベントのみを制御します。 プライバシーポリシー