속성 카탈로그 | Unico Developer Portal

메인 콘텐츠로 건너뛰기

속성 카탈로그

credential.type에서 허용되는 문서 유형 목록입니다.

카탈로그는 Unico가 https://human-token-assets.unico.app/attribute-catalog.json에 게시하는 공개 JSON 파일입니다. 사용할 수 있는 코드는 이 파일에서 확인하세요.

{
  "schema_version": 1,
  "version": "2026-10-29.1",
  "attributes": [
    { "code": "DUI_TYPE_BR_CPF", "country_code": "BRA" },
    { "code": "DUI_TYPE_NG_BVN", "country_code": "NGA" }
  ]
}

code는 credential.type에 보내는 값입니다. 일치 여부는 정확히, 대소문자를 구분하여 판단합니다.
country_code는 해당 문서를 발급하는 국가의 ISO 3166-1 alpha-3 코드입니다. Human Plugin은 이 값을 data.ndocs의 countryCode로 응답합니다.

Human Plugin의 카탈로그 사용 방식

시작할 때 한 번 다운로드하여 메모리에 보관합니다. 새 카탈로그는 Human Plugin을 다음에 재시작할 때 반영됩니다.
10초 안에 유효한 카탈로그를 다운로드하지 못하면 Human Plugin은 시작되지 않습니다. human-token-assets.unico.app으로 나가는 HTTPS 아웃바운드를 허용하세요.
카탈로그 호스트에는 고객 데이터가 전송되지 않습니다.
카탈로그에 없는 credential.type으로 생성을 요청하면, 아무것도 저장하거나 전송하기 전에 422 ATTRIBUTE_TYPE_NOT_SUPPORTED로 거부됩니다.

Human Plugin의 카탈로그 사용 방식