리소스

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

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

Method	URI	Description
POST		리소스 생성은 TUS protocol을 통해 생성됩니다. 자세한 내용은 업로드 페이지를 참고하세요.
PATCH	/{user-uuid}/{container}/{resourceUuid}	리소스 설명을 수정합니다.
GET	/{user-uuid}/{container}/{resourceUuid}	리소스 URI를 전달합니다.
DELETE	/{user-uuid}/{container}/{resourceUuid}	(WIP)리소스를 삭제합니다.
OPTION	/{user-uuid}/{container}/{resourceUuid}	허용된 작업을 전달합니다.
HEAD	/{user-uuid}/{container}/{resourceUuid}	리소스의 메타 정보를 전달합니다.

PATCH

리소스 설명을 수정합니다.

Patch /{user-uuid}/{container}/{resourceUuid}

Response

204 OK

GET

리소스의 URI 또는 메타 데이터를 조회할 수 있습니다. query에 따라서 다양한 데이터를 조회할 수 있습니다.

리소스 조회

리소스를 URI를 조회할 수 있습니다. 에셋의 경우 query를 이용하여 catalog.json에 대한 URI를 전달 받을 수 있습니다.

GET /{user-uuid}/{container}/{resourceUuid}

Response

200 OK

{
  "uri": "https://d34gpj6pbb26l6.cloudfront.net/resources/asset/24857c56-26de-4d1e-b584-4e7cd6f5bf3f/windows/test.jpg",
  "type": "Resource"
}

메타 데이터 조회

query를 통해 메타 데이터를 조회할 수 있습니다.

GET /{user-uuid}/{container}/{resourceUuid}?type=meta
GET /{user-uuid}/{container}/{resourceUuid}?type=asset

Response

200 OK

{
  "_id": "64479e975005c9084b0c5db2",
  "uuid": "42190441-fefe-4cce-b7f1-a71d09fc7d05",
  "type": "BasicContainer",
  "name": "container",
  "parents": "/",
  "description": "container description",
  "owners": ["client-id"]
}

DELETE(WIP)

OPTION

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

HEAD

Allow Header를 통해 허용된 HTTP Method를 전달합니다.

API 상세 내용은 API 문서 참고