Skip to main content

TUS Upload

리소스는 Tus 프로토콜을 사용하여 업로드 할 수 있습니다. HTTP 메서드를 사용하며 재개 가능한 리소스 업로드를 지원합니다.

업로드된 리소스는 CDN을 통해 전 세계에 배포되고 클라이언트에 가장 가까운 서버에서 호출됩니다.

MethodURLDescription
POST/{user-uuid}/{container}/tusUpload리소스 업로드에 필요한 정보를 생성합니다.
PUT/{user-uuid}/{container}/tusUpload/{resourceUuid}리소스 덮어쓰기를 위한 정보를 생성합니다.
PATCH/{user-uuid}/{container}/tusUpload/{resourceUuid}리소스 버퍼를 업로드 합니다.
OPTIONS/{user-uuid}/{container}/tusUpload/{resourceUuid}허용된 작업을 전달합니다.
HEAD/{user-uuid}/{container}/tusUpload/{resourceUuid}리소스 업로드의 메타 정보를 전달합니다.

POST​

리소스의 메타 데이터를 저장하고, Uuid를 전달합니다.

POST /{user-uuid}/{container}/tusUpload
Upload-Length: 리소스 전체 크기
Upload-Metadata: 리소스 메타 데이터 - filename, sub_path, asset_resource_uuid, is_catalog, etc..
Description: 리소스 설명

Response

201 OK
Tus-Resumable: tus 버전
Location: 리소스 업로드를 위한 uri

PUT​

리소스를 덮어 쓰기 위한 메타 데이터를 저장합니다.

PUT /{user-uuid}/{container}/tusUpload/{resourceUuid}
Upload-Length: 리소스 전체 크기
Upload-Metadata: 리소스 메타 데이터 - filename, sub_path, asset_resource_uuid, is_catalog, etc..
Description: 리소스 설명

Response

204 OK
Tus-Resumable: tus 버전
Location: 리소스 업로드를 위한 uri

PATCH​

리소스 버퍼를 업로드 합니다.

PATCH /{user-uuid}/{container}/tusUpload/{resourceUuid}
Upload-Offset: 시작 버퍼 위치
Content-Length: 버퍼 크기
Content-Type: application/offset+octet-stream
Upload-Checksum: Checksum 알고리즘

Response

204 OK
Upload-Offset:업로드된 바이트의 길이

Header를 통해 TUS 메타 데이터 조회 URI를 전달합니다.

HEAD /{user-uuid}/{container}/tusUpload/{resourceUuid}

Response

200 OK
Upload-Length: 리소스 전체 크기
Upload-Offset: 저장된 리소스 크기
Upload-Metadata: 리소스 메타 데이터 - filename, sub_path, asset_resource_uuid, is_catalog, etc..

OPTIONS​

Header를 통해 TUS Protocol 정보를 전달합니다.

OPTIONS /{user-uuid}/{container}/tusUpload/{resrouceUuid}

Response

204 OK
Tus-Version: tus 버전
Tus-Max-Size: tus 업로드 최대 크기
Tus-Extension: tus 확장 필드
Tus-Checksum-Algorithm: checksum 알고리즘

API 상세 내용은 API 문서 참고