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

ユーザー間取引(C2C)アイテム機能

ユーザー間取引アイテム機能は、ユーザーがDOSIブランドストアで販売登録したデジタルアイテムのリストを閲覧し、パートナー企業のサービスで販売中止できるエンドポイント群です。

ユーザーが販売登録したデジタルアイテムを閲覧して販売を中止するには、まずプロキシ(Proxy)を設定する必要があります。

接続情報

開発環境DOSI SDK base URI
プロダクション環境https://sdk-api.dosi.world

ユーザーが販売中のデジタルアイテム一覧の取得

ユーザーがDOSIブランドストアで販売中のデジタルアイテム一覧を取得します。

GET {DOSI SDK base URI}/v1/store/sales

プロキシ(proxy)を承認したユーザーアカウントでのみ使用できます。

Path

None

Query

Name
TypeDescription
Required
contractIdstring

DOSI SDK利用申請後に取得したcontract ID。リクエストヘッダーのAuthorizationで指定されたDOSIチャネルにリンクされたcontract IDを入力する必要があります。

walletAddressstring

ユーザーのDOSIアカウントのウォレットアドレス

pageSizenumber

1ページに含まれるデジタルアイテム数

  • デフォルト値:10
  • 最小値:1
  • 最大値:100
pageTokenstring

ページの開始を示すトークン(前のページを取得したときの応答のnextPageToken)。指定されていない場合は、最初のページを取得します。

Body

None

Headers
  • Authorization: Basic <「DOSIチャネルID:シークレット」をBase64でエンコードした値>

Request examples

curl -v -X GET "https://sdk-api.dosi.world/v1/store/sales?contractId=9138939b&walletAddress=link1xyz" \
--header 'Authorization: Basic xxxx'

ユーザーが販売中のデジタルアイテムを販売中止

ユーザーがDOSIブランドストアで販売中の商品を販売中止します。このエンドポイントを使用することで、パートナー企業のサービスに販売中止機能を実装できます。

DELETE {DOSI SDK base URI}/v1/store/sales/{saleId}

プロキシ(proxy)を承認したユーザーアカウントでのみ使用できます。

Path

Name
TypeDescription
saleIdnumber

販売を中止するデジタルアイテムのsale ID。DOSIブランドストアで販売登録を行ったときに発行されたIDを入力してください。

販売中のデジタルアイテム一覧の取得でも確認できます。

Query

None

Body

None

Headers
  • Authorization: Basic <「DOSIチャネルID:シークレット」をBase64でエンコードした値>

Request examples

curl -v -X DELETE "https://sdk-api.dosi.world/v1/store/sales/1234" \
--header 'Authorization: Basic xxxxxxxx'

販売中止のステータスの取得

ユーザーがデジタルアイテムを販売中止にした場合、そのステータスを取得します。

GET {DOSI SDK base URI}/v1/store/sales/{saleId}/status

Path

Name
TypeDescription
saleIdnumber

取得するデジタルアイテムのsale ID。DOSIブランドストアで販売登録を行ったときに発行されたIDを入力してください。

販売中のデジタルアイテム一覧の取得でも確認できます。

Query

None

Body

None

Headers
  • Authorization: Basic <「DOSIチャネルID:シークレット」をBase64でエンコードした値>

Request examples

curl -v -X GET "https://sdk-api.dosi.world/v1/store/sales/1234/status" \
--header 'Authorization: Basic xxxx'