個体を確保する
販売可能な個体を1点確保します。expiresAtは現在より後、90日以内。省略すると無期限です。 同じrequestId・同じ内容の再実行は200、初回作成は201です。requestIdを別の内容へ流用するとidempotency_conflictになります。 inventory:readに加え、この操作のスコープと許可したメンバーのinventory.write権限が必要です。
/inventory/holdsAuthorizationOAuth2 アクセストークン · header必須認可コードフロー(PKCE S256 必須)。認可・トークン・更新のリクエストには resource=https://api.toreca-cloud.com/partner/v1 を付けます。アクセストークンは15分、リフレッシュトークンは90日有効で、更新のたびに入れ替わります。
inventory:readinventory:writeapplication/jsonrequestIdstring<uuid>必須inventoryItemIdstring<uuid>必須purposestring必須oripasaledestinationLabelstring必須reasonstring必須externalRefstringexpiresAtstring<date-time>成功
idstring<uuid>必須createdAtstring<date-time>必須updatedAtstring<date-time>必須orderNumberstring必須statusstring必須reservedawaiting_shipmentshippedcancelledversioninteger必須inventoryItemIdstring<uuid>必須purposestring必須oripasaledestinationLabelstring必須externalRefstring | null必須プロパティを表示プロパティを非表示
stringnullexpiresAtstring<date-time> | null必須プロパティを表示プロパティを非表示
string<date-time>nulltrackingNumberstring | null必須プロパティを表示プロパティを非表示
stringnullsaleobject | null必須プロパティを表示プロパティを非表示
amountMinorinteger必須currencystring必須sourcestring必須enteredmarketnull作成しました
idstring<uuid>必須createdAtstring<date-time>必須updatedAtstring<date-time>必須orderNumberstring必須statusstring必須reservedawaiting_shipmentshippedcancelledversioninteger必須inventoryItemIdstring<uuid>必須purposestring必須oripasaledestinationLabelstring必須externalRefstring | null必須プロパティを表示プロパティを非表示
stringnullexpiresAtstring<date-time> | null必須プロパティを表示プロパティを非表示
string<date-time>nulltrackingNumberstring | null必須プロパティを表示プロパティを非表示
stringnullsaleobject | null必須プロパティを表示プロパティを非表示
amountMinorinteger必須currencystring必須sourcestring必須enteredmarketnullinvalid_request。パラメーターが正しくありません。
errorstring必須エラーのコード
scopestringinsufficient_scope のとき、足りない権限
requestIdstring<uuid>inventoryItemIdsstring<uuid>[]holdIdsstring<uuid>[]commitmentIdsstring<uuid>[]invalid_token。トークンがない、期限切れ、または別のリソース向けです。
errorstring必須エラーのコード
scopestringinsufficient_scope のとき、足りない権限
requestIdstring<uuid>inventoryItemIdsstring<uuid>[]holdIdsstring<uuid>[]commitmentIdsstring<uuid>[]insufficient_scope、connection_revoked、client_disabled、forbidden のいずれかです。
errorstring必須エラーのコード
scopestringinsufficient_scope のとき、足りない権限
requestIdstring<uuid>inventoryItemIdsstring<uuid>[]holdIdsstring<uuid>[]commitmentIdsstring<uuid>[]競合・requestIdの流用・受取未確認
errorstring必須エラーのコード
scopestringinsufficient_scope のとき、足りない権限
requestIdstring<uuid>inventoryItemIdsstring<uuid>[]holdIdsstring<uuid>[]commitmentIdsstring<uuid>[]現在の状態・対象・値では実行できません。errorと対象IDを確認します。
errorstring必須エラーのコード
scopestringinsufficient_scope のとき、足りない権限
requestIdstring<uuid>inventoryItemIdsstring<uuid>[]holdIdsstring<uuid>[]commitmentIdsstring<uuid>[]
