メインコンテンツまでスキップ
バージョン: 1.2.0-1.3.0

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のデジタルアイテム一覧の取得を使用してください。

Path

None

Query

Name
TypeDescription
Required
chainNamestring

使用するチェーン。固定値の"realnet"にします。

sortOrderstring

並べ替え順。以下のいずれかを選択してください。

  • CONTRACT_ID_ASC_TOKEN_TYPE_ASC_TOKEN_INDEX_ASC
  • CONTRACT_ID_DESC_TOKEN_TYPE_DESC_TOKEN_INDEX_DESC
pageSizenumber

1ページに含まれるデジタルアイテム数。0より大きく100以下である必要があります。

pageTokenstring

ページの開始を示すトークン。この値を指定すると、そのトークンを基準に次のページにあるデジタルアイテムを取得します。指定されていない場合は、最初のページを取得します。

この値は、URIエンコードする必要があります。

使い方

  • 最初のページを取得するために、最初の呼び出しの際にはこの値を指定しないでください。
  • 次のpageSize個のデジタルアイテムを取得するには、前に呼び出して受け取った応答のpageTokens.nextを入力します。
  • 前のpageSize個のデジタルアイテムを取得するには、前に呼び出して受け取った応答のpageTokens.prevを入力します。
contractIdstring

フィルタリングするcontract ID。このcontract IDのデジタルアイテムのみを取得します。

tokenTypestring

フィルタリングするアイテムタイプ。このタイプのデジタルアイテムのみを取得します。

Body

None

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

Request examples

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'