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	1ページに含まれるデジタルアイテム数。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>

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>'

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": ""
  }
}