Metadata API

Metadata API는 NFT(Non-fungible Token) 컨트랙트 표준인 KIP-17과 MT(Multi Token) 컨트랙트 표준인 KIP-37의 메타데이터를 관리합니다. 여기서 메타데이터는 토큰 속성을 나타내는 데이터입니다. Metadata API의 기능은 다음과 같습니다.

• 에셋 업로드
• 메타데이터 업로드
• 스토리지 생성 및 조회

에셋 업로드

토큰 속성으로 저장할 이미지나 영상 파일을 업로드합니다. 아래 항목을 요청 스키마로 입력한 후 API를 실행하면 파일 이름과 콘텐츠 타입, URI를 반환합니다.

• file

  업로드할 파일의 저장 경로를 입력합니다.

메타데이터 업로드

토큰의 메타데이터를 업로드합니다. 외부에서 접근할 수 있도록 URI를 제공합니다. 아래 항목을 요청 파라미터로 입력한 후 API를 실행하면 에셋 업로드와 마찬가지로 파일 이름과 콘텐츠 타입, URI를 반환합니다.

• metadata

  JSON 형태의 메타데이터입니다. 파일 이름과 설명, 이미지 링크를 입력합니다.

스토리지 생성 및 조회

스토리지란 일종의 저장소와 같습니다. 체인 아이디(네트워크) 별로 다른 스토리지를 생성할 수 있습니다. 각 스토리지 안에 메타데이터와 에셋이 속해있는 디렉토리 형태입니다.

KRN (KAS Resource Name)당 하나의 storageID가 부여되며, 이 storageID는 uri path에 포함됩니다. 특정 스토리지에 메타데이터와 에셋을 저장하고 싶다면 x-krn 값을 지정하세요. x-krn을 별도로 지정하지 않는다면 업로드하는 메타데이터와 에셋은 default storage에 저장됩니다.

각 기능별 API 레퍼런스는 KAS API Reference에서 확인할 수 있습니다.