메타 정보 입력 가이드
메타 정보는 파트너사의 온라인 상품을 DOSI 디지털 아이템으로 만들 때 입력하는 부가 정보입니다. 상품을 DOSI 브랜드 스토어에서 판매하도록 타입을 생성하거나 실링(sealing)할 때 메타 정보를 이용해 상품 속성을 입력할 수 있습니다.
실링할 때 입력한 디지털 아이템의 메타 정보는 DOSI 브랜드 스토어의 상품 속성에 나타납니다. 아이템 타입을 생성할 때 입력한 아이템 타입 메타 정보는 DOSI 브랜드 스토어에는 나타나지 않지만, 블록체인에는 기록되므로 파트너사 서비스에서 활용할 수 있습니다.
기본 입력 규정
메타 정보는 다음 규정에 따라 입력해야 합니다.
형식: JSON
키: 문자열. 대소문자 구분. 최소 1자 ~ 최대 15자(권장 사항)
값: 문자열. 대소문자 구분. 최소 1자 ~ 최대 15자(권장 사항)
키나 값이 15자를 초과하면 DOSI에서 정상으로 출력하지 못합니다.
- 객체나 배열 형태는 지원하지 않습니다.
- 키나 값에 숫자나 객체(object)를 직접 입력할 수는 없지만, 숫자나 객체를 문자열 형식으로 변환해 입력할 수는 있습니다.
예: 1(입력 불가), "1"(입력 가능) - 특수 문자를 입력할 수 있으나, 화면에 올바로 나타나지 않을 수 있으므로 권장하지 않습니다.
- 사용자가 볼 화면을 고려해 대소문자를 명확히 구분해서 입력하는 것이 좋습니다.
최대 글자 수: 1,000자(필수 사항)
키와 JSON 문법 기호도 글자 수에 포함하므로, 값을 표현할 순수 문자열은 최대 700자 정도로 가정하고 입력하는 것이 좋습니다.
속성
디지털 아이템의 여러 속성(파츠)은 메타 정보에 표기할 수 있습니다. 속성(property)은 JSON 형식 키-값 쌍으로 표현하며, 키가 해당 속성의 이름이 됩니다.
"Property name": "Value"
입력할 수 있는 속성 개수는 최대 20개입니다.
속성 표출 예시
메타 정보에 다음처럼 세 속성을 입력했다고 가정합시다.
{ "collection": "Platinum Pass Leta", "membership": "Platinum", "Hero name": "Leta" }
DOSI 디지털 아이템 페이지에서는 아래처럼 속성의 키와 값이 나타납니다.
속성 변경
재실링할 때 메타 정보를 입력해 이미 설정한 디지털 아이템의 속성을 변경할 수 있습니다.