個体の現在の評価額を読む
読み取り専用のPOSTです。最大200件の重複しない個体IDを指定します。権限の範囲外・存在しない個体は返しません。評価額がない個体はmarketValueがnullです。価格だけの変化は変更フィードに出ないため、現在価格はこの操作で読みます。
POST
/inventory/market-values認証
AuthorizationOAuth2 アクセストークン · header必須認可コードフロー(PKCE S256 必須)。認可・トークン・更新のリクエストには resource=https://api.toreca-cloud.com/partner/v1 を付けます。アクセストークンは15分、リフレッシュトークンは90日有効で、更新のたびに入れ替わります。
スコープ:
inventory:readリクエストボディ
必須application/jsonidsstring<uuid>[]必須最小項目数 1 · 最大項目数 200
レスポンス
200
成功
itemsobject[]必須プロパティを表示プロパティを非表示
object の配列idstring<uuid>必須marketValueMarketValue | null必須プロパティを表示プロパティを非表示
いずれか 1 つ:
MarketValue
amountMinorinteger必須currencystring必須pricedAtstring<date-time>必須null
null400
invalid_request。パラメーターが正しくありません。
errorstring必須エラーのコード
scopestringinsufficient_scope のとき、足りない権限
requestIdstring<uuid>inventoryItemIdsstring<uuid>[]holdIdsstring<uuid>[]commitmentIdsstring<uuid>[]401
invalid_token。トークンがない、期限切れ、または別のリソース向けです。
errorstring必須エラーのコード
scopestringinsufficient_scope のとき、足りない権限
requestIdstring<uuid>inventoryItemIdsstring<uuid>[]holdIdsstring<uuid>[]commitmentIdsstring<uuid>[]403
insufficient_scope、connection_revoked、client_disabled、forbidden のいずれかです。
errorstring必須エラーのコード
scopestringinsufficient_scope のとき、足りない権限
requestIdstring<uuid>inventoryItemIdsstring<uuid>[]holdIdsstring<uuid>[]commitmentIdsstring<uuid>[]
