コンテンツにスキップ
トレカクラウド
Esc
↑↓移動↵開く⌘Jプレビュー

同じ拠点内で棚を移動する

同じ拠点内の有効な棚へ移します。同じ棚ならmoved=false。別拠点はdifferent_siteで拒否され、transfersを使います。 inventory:readに加え、この操作のスコープと許可したメンバーのinventory.write権限が必要です。

POST/inventory/items/{id}/move
認証
AuthorizationOAuth2 アクセストークン · header必須

認可コードフロー(PKCE S256 必須)。認可・トークン・更新のリクエストには resource=https://api.toreca-cloud.com/partner/v1 を付けます。アクセストークンは15分、リフレッシュトークンは90日有効で、更新のたびに入れ替わります。

スコープ:inventory:readinventory:move
パスパラメーター
idstring<uuid>必須
リクエストボディ
必須application/json
toLocationIdstring<uuid>必須
reasonstring必須
最小長 1 · 最大長 2000
レスポンス
200

成功

movedboolean必須
itemInventoryItem必須
プロパティを表示
idstring<uuid>必須
createdAtstring<date-time>必須
updatedAtstring<date-time>必須
assetNumberstring必須
sourceKindstring必須
許可される値:purchasereceipttenant_transfer
statusstring必須
versioninteger必須
siteIdstring<uuid> | null必須
プロパティを表示
いずれか 1 つ:
string<uuid>
string<uuid>
null
null
locationIdstring<uuid> | null必須
プロパティを表示
いずれか 1 つ:
string<uuid>
string<uuid>
null
null
gradeobject | null必須
プロパティを表示
いずれか 1 つ:
object
serviceCodestring必須
serviceNamestring必須
serviceKindstring必須
許可される値:third_partyinternal
codestring必須
labelstring必須
numericScorenumber | null必須
プロパティを表示
いずれか 1 つ:
number
number
null
null
null
null
certificationNumberstring | null必須
プロパティを表示
いずれか 1 つ:
string
string
null
null
certificationVerifiedboolean必須
conditionNotestring | null必須
プロパティを表示
いずれか 1 つ:
string
string
null
null
acquisitionAmountMinorinteger | null必須
プロパティを表示
いずれか 1 つ:
integer
integer
null
null
currencystring必須
acquiredAtstring<date-time>必須
lastMovedAtstring<date-time>必須
allocationstring必須
許可される値:yoursothersnone
holdableboolean必須
commitmentobject | null必須
プロパティを表示
いずれか 1 つ:
object
idstring<uuid>必須
purposestring必須
許可される値:oripasale
labelstring必須
externalRefstring | null必須
プロパティを表示
いずれか 1 つ:
string
string
null
null
null
null
marketValueMarketValue | null必須
プロパティを表示
いずれか 1 つ:
MarketValue
amountMinorinteger必須
currencystring必須
pricedAtstring<date-time>必須
null
null
conditionTagsobject[]必須
プロパティを表示
object の配列
idstring<uuid>必須
namestring必須
photosobject必須
プロパティを表示
frontobject | null必須
プロパティを表示
いずれか 1 つ:
object
urlstring<uri>必須
updatedAtstring<date-time>必須
null
null
backobject | null必須
プロパティを表示
いずれか 1 つ:
object
urlstring<uri>必須
updatedAtstring<date-time>必須
null
null
cardobject必須
プロパティを表示
idstring<uuid>必須
namestring必須
localizedNamesobject必須
cardNumberstring | null必須
プロパティを表示
いずれか 1 つ:
string
string
null
null
languageCodestring必須
variantstring | null必須
プロパティを表示
いずれか 1 つ:
string
string
null
null
finishstring | null必須
プロパティを表示
いずれか 1 つ:
string
string
null
null
imageUrlstring | null必須
プロパティを表示
いずれか 1 つ:
string
string
null
null
rarityobject | null必須
プロパティを表示
いずれか 1 つ:
object
codestring必須
namestring必須
null
null
setobject | null必須
プロパティを表示
いずれか 1 つ:
object
idstring<uuid>必須
codestring必須
namestring必須
nameEnstring | null必須
プロパティを表示
いずれか 1 つ:
string
string
null
null
null
null
gameGame必須
プロパティを表示
idstring<uuid>
codestring
namestring
400

invalid_request。パラメーターが正しくありません。

errorstring必須

エラーのコード

scopestring

insufficient_scope のとき、足りない権限

requestIdstring<uuid>
inventoryItemIdsstring<uuid>[]
holdIdsstring<uuid>[]
commitmentIdsstring<uuid>[]
401

invalid_token。トークンがない、期限切れ、または別のリソース向けです。

errorstring必須

エラーのコード

scopestring

insufficient_scope のとき、足りない権限

requestIdstring<uuid>
inventoryItemIdsstring<uuid>[]
holdIdsstring<uuid>[]
commitmentIdsstring<uuid>[]
403

insufficient_scope、connection_revoked、client_disabled、forbidden のいずれかです。

errorstring必須

エラーのコード

scopestring

insufficient_scope のとき、足りない権限

requestIdstring<uuid>
inventoryItemIdsstring<uuid>[]
holdIdsstring<uuid>[]
commitmentIdsstring<uuid>[]
404

not_found

errorstring必須

エラーのコード

scopestring

insufficient_scope のとき、足りない権限

requestIdstring<uuid>
inventoryItemIdsstring<uuid>[]
holdIdsstring<uuid>[]
commitmentIdsstring<uuid>[]
409

競合・requestIdの流用・受取未確認

errorstring必須

エラーのコード

scopestring

insufficient_scope のとき、足りない権限

requestIdstring<uuid>
inventoryItemIdsstring<uuid>[]
holdIdsstring<uuid>[]
commitmentIdsstring<uuid>[]
422

現在の状態・対象・値では実行できません。errorと対象IDを確認します。

errorstring必須

エラーのコード

scopestring

insufficient_scope のとき、足りない権限

requestIdstring<uuid>
inventoryItemIdsstring<uuid>[]
holdIdsstring<uuid>[]
commitmentIdsstring<uuid>[]
試してみる
サーバー
認証
パラメーター
ボディapplication/json
リクエスト
curl -X POST 'https://api.toreca-cloud.com/partner/v1/inventory/items/497f6eca-6276-4993-bfeb-53cbbbba6f08/move' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "toLocationId": "e81ad314-9cb9-45ae-9ad9-f1b5ebcc7aae",
  "reason": "string"
}'
レスポンス
{
  "moved": true,
  "item": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "createdAt": "2019-08-24T14:15:22Z",
    "updatedAt": "2019-08-24T14:15:22Z",
    "assetNumber": "string",
    "sourceKind": "purchase",
    "status": "string",
    "version": 0,
    "siteId": "60189e9c-7d12-438c-b9ca-6998d9c364b1",
    "locationId": "1a5515a3-ba81-4a42-aee7-ad9ffc090a54",
    "grade": {
      "serviceCode": "string",
      "serviceName": "string",
      "serviceKind": "third_party",
      "code": "string",
      "label": "string",
      "numericScore": 0
    },
    "certificationNumber": "string",
    "certificationVerified": true,
    "conditionNote": "string",
    "acquisitionAmountMinor": 0,
    "currency": "string",
    "acquiredAt": "2019-08-24T14:15:22Z",
    "lastMovedAt": "2019-08-24T14:15:22Z",
    "allocation": "yours",
    "holdable": true,
    "commitment": {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "purpose": "oripa",
      "label": "string",
      "externalRef": "string"
    },
    "marketValue": {
      "amountMinor": 0,
      "currency": "JPY",
      "pricedAt": "2019-08-24T14:15:22Z"
    },
    "conditionTags": [
      {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "name": "string"
      }
    ],
    "photos": {
      "front": {
        "url": "http://example.com",
        "updatedAt": "2019-08-24T14:15:22Z"
      },
      "back": {
        "url": "http://example.com",
        "updatedAt": "2019-08-24T14:15:22Z"
      }
    },
    "card": {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "name": "string",
      "localizedNames": {
        "property1": "string",
        "property2": "string"
      },
      "cardNumber": "string",
      "languageCode": "string",
      "variant": "string",
      "finish": "string",
      "imageUrl": "string",
      "rarity": {
        "code": "string",
        "name": "string"
      },
      "set": {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "code": "string",
        "name": "string",
        "nameEn": "string"
      },
      "game": {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "code": "string",
        "name": "string"
      }
    }
  }
}

このページは役に立ちましたか?