에셋 업로드

에셋을 업로드합니다. jpg, png, gif 등의 파일을 업로드할 수 있습니다. 업로드 후 외부 접근이 가능한 public URI을 제공합니다.

아래처럼 curl을 이용해 파일 업로드를 하실 수 있습니다.

curl --location --request POST 'https://metadata-api.klaytnapi.com/v1/metadata/asset' \
--header 'x-chain-id: 8217' \
--header 'Authorization: Basic S0FTS0U0Mjc5Q01VMVhLVDg1UTRBVkRBOlFEMENMam5XRW94TzZfQ3pYLV9oLWRrQkZnMDVxR1FnbWlYcDAwVno=' \
--form 'file=@"/Users/usernamed/Documents/files/1kbfile.jpg"'

참고

응답에 포함된 URI의 형식은 다음과 같습니다:

https://metadata-store.klaytnapi.com/{storage-id}/{assetID}.{extension}.

  • {storage-id}(UUID)는 각 유저에게 자동으로 부여되는 값입니다.
  • {assetID}는 업로드한 asset에 부여된 고유한 식별값입니다.
Request
Security:
basic
header Parameters
x-chain-id
required
string

Kaia 네트워크 체인 ID (1001 또는 8217)

Request Body schema: multipart/form-data

업로드하고자 하는 파일을 첨부합니다.

file
required
string

multipart/form-data로 파일을 추가합니다. 파일 개수는 1개, 용량은 10MB로 제한됩니다. 용량이 10MB을 넘을 경우 invalid input 에러가 발생합니다.

Responses
200

요청이 성공적입니다.

400

요청이 유효하지 않습니다.

post/v1/metadata/asset
Request samples
multipart/form-data
{
  "file": "@\"/Users/username/Documents/files/1kbfile.jpg\""
}
Response samples
application/json
{}