掲載・当選を一括で解除する
最大200件、ID重複不可。全件成功または全件取り消しです。setAsideと紛失時の扱いは単体解除と同じです。 inventory:readに加え、この操作のスコープと許可したメンバーのinventory.write権限が必要です。
POST
/inventory/commitments/release-batch認証
AuthorizationOAuth2 アクセストークン · header必須認可コードフロー(PKCE S256 必須)。認可・トークン・更新のリクエストには resource=https://api.toreca-cloud.com/partner/v1 を付けます。アクセストークンは15分、リフレッシュトークンは90日有効で、更新のたびに入れ替わります。
スコープ:
inventory:readinventory:writeリクエストボディ
必須application/jsoncommitmentIdsstring<uuid>[]必須最小項目数 1 · 最大項目数 200
reasonstring必須最小長 1 · 最大長 2000
setAsidebooleanレスポンス
200
成功
commitmentsCommitment[]必須プロパティを表示プロパティを非表示
Commitment の配列idstring<uuid>必須createdAtstring<date-time>必須updatedAtstring<date-time>必須inventoryItemIdstring<uuid>必須assetNumberstring必須purposestring必須許可される値:
oripasalelabelstring必須externalRefstring | null必須プロパティを表示プロパティを非表示
いずれか 1 つ:
string
stringnull
nullstatusstring必須許可される値:
on_saleallocatedshippingblockedshippedreleasedendedallocatedAtstring<date-time> | null必須プロパティを表示プロパティを非表示
いずれか 1 つ:
string<date-time>
string<date-time>null
nullallocationRefstring | null必須プロパティを表示プロパティを非表示
いずれか 1 つ:
string
stringnull
nullshipmentIdstring<uuid> | null必須プロパティを表示プロパティを非表示
いずれか 1 つ:
string<uuid>
string<uuid>null
nullclosedAtstring<date-time> | null必須プロパティを表示プロパティを非表示
いずれか 1 つ:
string<date-time>
string<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>[]409
競合・requestIdの流用・受取未確認
errorstring必須エラーのコード
scopestringinsufficient_scope のとき、足りない権限
requestIdstring<uuid>inventoryItemIdsstring<uuid>[]holdIdsstring<uuid>[]commitmentIdsstring<uuid>[]422
現在の状態・対象・値では実行できません。errorと対象IDを確認します。
errorstring必須エラーのコード
scopestringinsufficient_scope のとき、足りない権限
requestIdstring<uuid>inventoryItemIdsstring<uuid>[]holdIdsstring<uuid>[]commitmentIdsstring<uuid>[]
