ReCORE.co-api

EC出品

出品検索

概要

• 出品情報の検索を行う

基本情報

• リクエストパス: GET /ec/inventories
• JWTスコープ: ec:inventory:index
• 必須個別JWTパラメータ: なし
• レートリミット: 5 rps

query

key	説明	制約など
ids	出品ID	整数のみ、カンマ区切りで複数指定可能
item_ids	在庫ID	整数のみ、カンマ区切りで複数指定可能
statuses	出品ステータス	カンマ区切りで複数指定可能
ec_account_id	ECアカウントID	-
created_at_from	作成日から	2024-04-12 12:08:38 形式
created_at_to	作成日まで	同上
updated_at_from	更新日から	同上
updated_at_to	更新日まで	同上
done_at_from	出品日から	同上
done_at_to	出品日まで	同上
page	ページ	整数のみ、デフォルト:1
limit	1ページあたりの件数	整数のみ、デフォルト:50、最大: 250
cursor	ページカーソル	-

例

• Request

GET /ec/inventories?ids=1047

• Response

[
  {
    "id": 1047,
    "ec_account": {
      "id": 8,
      "mall_id": "RAKUTEN"
    },
    "mall_product_code": "rc_itms6ltwuezu_hs0d",
    "mall_url": "https://item.rakuten.co.jp/...",
    "status": "DONE",
    "title": "テスト出品",
    "image_url": "https://...",
    "created_at": 1727095280,
    "updated_at": 1727101864,
    "done_at": 1727095312,
    "variants": [
      {
        "id": 141,
        "mall_item_code": "rc_itms6ltwuezu_hs0d",
        "price": 4,
        "quantity": 0,
        "title": null,
        "image_url": null,
        "allocations": [
          {
            "id": 141,
            "item_id": 325,
            "location_id": 1,
            "price_ratio": 1,
            "quantity_ratio": 1
          }
        ]
      }
    ]
  }
]

key	type	説明
*	array<object>	出品
*.id	int	出品ID
*.ec_account	object	ECアカウント
*.ec_account.id	int	ECアカウントID
*.ec_account.mall_id	string	モールID
*.mall_product_code	string | null	モール商品コード
*.mall_url	string | null	モール出品詳細URL
*.status	string	出品ステータス
*.title	string | null	タイトル
*.image_url	string | null	画像URL
*.created_at	int | null	出品作成日
*.updated_at	int | null	出品更新日
*.done_at	int | null	出品完了日
*.variants	array<object>	バリエーション
*.variants.*.id	int	バリエーションID
*.variants.*.mall_item_code	string	SKU
*.variants.*.price	int	価格
*.variants.*.quantity	int	数量
*.variants.*.title	string | null	バリエーションタイトル
*.variants.*.image_url	string | null	バリエーション画像URL
*.variants.*.allocations	array<object>	在庫割当
*.variants.*.allocations.*.id	int	在庫割当ID
*.variants.*.allocations.*.item_id	int	在庫ID
*.variants.*.allocations.*.location_id	int	ロケーションID
*.variants.*.allocations.*.price_ratio	float	出品額に対する価格比
*.variants.*.allocations.*.quantity_ratio	int	出品数量に対する割当比

• ステータス
  • PENDING 出品待ち
  • IN_PROGRESS 処理中
  • DONE 出品中
  • CLOSED 出品終了

出品取得

概要

• 出品情報を1件取得する

基本情報

• リクエストパス: GET /ec/inventories/{ec_inventory_id}
• JWTスコープ: ec:inventory:show
• 必須個別JWTパラメータ: なし
• レートリミット: 5 rps

例

• Request

GET /ec/inventories/179

• Response

出品検索のresponse[0]と同様