createScopedStorageUpload
POST
/api/v1/storage-transfer/v2/sessions/{session_id}/uploads
const url = 'https://dev.api.endueos.com/api/v1/storage-transfer/v2/sessions/wss_01J9ZK3Q8M4XW7D2N5R6T0V1BC/uploads';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"sha256":"example","size_bytes":1}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://dev.api.endueos.com/api/v1/storage-transfer/v2/sessions/wss_01J9ZK3Q8M4XW7D2N5R6T0V1BC/uploads \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "sha256": "example", "size_bytes": 1 }'파라미터
섹션 제목: “파라미터”경로 파라미터
섹션 제목: “경로 파라미터”session_id
필수
string
예시
wss_01J9ZK3Q8M4XW7D2N5R6T0V1BC헤더 파라미터
섹션 제목: “헤더 파라미터”X-Idempotency-Key
string
요청 본문필수
섹션 제목: “요청 본문필수”Media typeapplication/json
object
sha256
필수
string
size_bytes
필수
integer format: int64
예시자동 생성
{ "sha256": "example", "size_bytes": 1}201
섹션 제목: “201”만들었다.
Media typeapplication/json
object
data
필수
object
upload_id
필수
string
session_id
필수
string
sha256
필수
string
size_bytes
필수
integer format: int64
state
필수
string
part_bytes
필수
integer format: int64
meta
필수
object
request_id
필수
string
timestamp
필수
string format: date-time
duration
서버 처리 시간(ms).
integer format: int32
예시
{ "data": { "upload_id": "wsu_01J9ZK3Q8M4XW7D2N5R6T0V1BC", "session_id": "wss_01J9ZK3Q8M4XW7D2N5R6T0V1BC", "state": "uploading" }}400
섹션 제목: “400”요청 형식이 틀렸다 — VALIDATION_ERROR(details.errors[]) 또는 BAD_REQUEST. 본문은 오류 봉투.
401
섹션 제목: “401”인증이 없거나 무효다 — UNAUTHORIZED. 본문은 오류 봉투.
402
섹션 제목: “402”크레딧이 없다 — INSUFFICIENT_CREDITS (충전하면 다시 된다). 본문은 오류 봉투.
404
섹션 제목: “404”없거나 내 것이 아니다 — *_NOT_FOUND. 본문은 오류 봉투.
409
섹션 제목: “409”지금 상태와 충돌한다 — 코드는 위 설명을 본다. 본문은 오류 봉투.
410
섹션 제목: “410”보관 기간이 지났다 — OUTPUT_EXPIRED. 본문은 오류 봉투.
429
섹션 제목: “429”한도를 넘었다 — Retry-After 초 뒤에 다시. 본문은 오류 봉투.
500
섹션 제목: “500”서버 오류 — INTERNAL_ERROR. 본문은 오류 봉투.
503
섹션 제목: “503”의존 서비스에 닿지 못했다 — 잠시 뒤 다시. 본문은 오류 봉투.