서명된 에셋 다운로드
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. |
관련 가이드
이 문서가 도움이 되었나요?
검색어, 코드 또는 자유 입력 텍스트는 수집하지 않습니다. 이 설정은 문서 상호작용 이벤트만 제어합니다. 개인정보 처리방침