User Account Connect (부수 기능)

User Account Connect API는 부수 기능을 제공합니다. 부수 기능은 User Account Connect의 연결 정보와 응답 모델을 사용합니다.

연결 정보

개발 환경	API base URI
운영 환경	https://api.dosi.world

액세스 토큰으로 디지털 아이템 목록 조회

액세스 토큰(access token)을 이용해 사용자 DOSI 계정에 있는 디지털 아이템 목록을 조회합니다.

GET {API base URI}/api/v2/member/items/balance

이 엔드포인트는 사용자가 DOSI에 로그인한 후 발급받은 액세스 토큰으로 보유한 디지털 아이템 목록을 조회합니다. 액세스 토큰이 없으면 Digital Item Connect의 디지털 아이템 목록 조회를 사용하세요.

Request

Response

Path

None

Query

Name	Type	Description	Required
chainName	string	사용할 체인. 고정값 "realnet"을 입력하세요.
sortOrder	string	정렬 순서. 다음 중 하나를 입력하세요. CONTRACT_ID_ASC_TOKEN_TYPE_ASC_TOKEN_INDEX_ASC CONTRACT_ID_DESC_TOKEN_TYPE_DESC_TOKEN_INDEX_DESC
pageSize	number	한 페이지에 포함할 디지털 아이템 수. 0보다는 크고 100보다 작거나 같아야 합니다.
pageToken	string	페이지 시작 지점 토큰. 이 값을 입력하면 해당 토큰을 기준으로 다음 페이지에 있는 디지털 아이템을 가져옵니다. 입력하지 않으면 첫 번째 페이지를 가져옵니다. 이 값은 반드시 URI 인코딩해야 합니다. 사용 방법 첫 번째 페이지를 가져오기 위해 처음 호출할 때는 이 값을 입력하지 마세요. 다음 pageSize개 디지털 아이템을 가져오려면 앞서 호출해서 받은 응답의 pageTokens.next를 입력하세요. 이전 pageSize개 디지털 아이템을 가져오려면 앞서 호출해서 받은 응답의 pageTokens.prev를 입력하세요.
contractId	string	필터링할 contract ID. 이 contract ID에 속한 디지털 아이템만 가져옵니다.
tokenType	string	필터링할 아이템 타입. 이 타입에 속한 디지털 아이템만 가져옵니다.

Body

None

Headers

• Authorization: Bearer <access token>
• Content-Type: application/json

Request examples

curl

curl -v -X GET "https://api.dosi.world/api/v2/member/items/balance?chainName=realnet&sortOrder=CONTRACT_ID_ASC_TOKEN_TYPE_ASC_TOKEN_INDEX_ASC&pageSize=50" \
  --header 'Authorization: Bearer <access token>' \
  --header 'Content-Type: application/json'

Name	Type	Description
items	array	디지털 아이템 목록
pageTokens	object

Response status code

200 OK

Response headers

None

Related errors

• NOT_FOUND
• NOT_FOUND_MEMBER
• INVALID_CHAIN_NAME

Response examples

{
  "items": [
      {
          "identifier": {
              "contractId": "8ae0feb0",
              "tokenType": "10000001",
              "tokenIndex": "00000004"
          },
          "name": "test",
          "meta": "",
          "imageUrl": "https://lbw-impro.line-apps.com/v1/daphne/token/8ae0feb0/1000000100000004",
          "dappName": "Dosi potatoes alpha"
      },
      {
          "identifier": {
              "contractId": "8ae0feb0",
              "tokenType": "10000001",
              "tokenIndex": "00000005"
          },
          "name": "test",
          "meta": "",
          "imageUrl": "https://lbw-impro.line-apps.com/v1/daphne/token/8ae0feb0/1000000100000005",
          "dappName": "Dosi potatoes alpha"
      },
      {
          "identifier": {
              "contractId": "8ae0feb0",
              "tokenType": "10000001",
              "tokenIndex": "00000006"
          },
          "name": "Dosi gamja",
          "meta": "",
          "imageUrl": "https://lbw-impro.line-apps.com/v1/daphne/token/8ae0feb0/1000000100000006",
          "dappName": "Dosi potatoes alpha"
      }
  ],
  "pageTokens": {
      "hasPrev": false,
      "hasNext": false,
      "prev": "",
      "next": ""
  }
}