查询库存项列表

GET 
/openapi/2026-07/inventory_items

分页返回库存项的列表。

请求

Query参数

inventory_item_ids string[]

库存项 ID 列表（至少 1 个）。 示例：?inventory_item_ids=1001&inventory_item_ids=1002

cursor string

分页游标

page_size int32

每页记录数

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object

inventory_items object[]

库存项列表

Array [

idstring

库存项 ID

product_idstring

商品 ID

variant_idstring

子款式 ID

trackingboolean

是否启用库存跟踪

tracking_policystring

库存跟踪策略

created_atstring

创建时间，ISO-8601 格式

updated_atstring

最后更新时间，ISO-8601 格式

]

cursorstring

分页游标

has_moreboolean

是否有更多记录

示例

{
  "code": "string",
  "message": "string",
  "data": {
    "inventory_items": [
      {
        "id": "string",
        "product_id": "string",
        "variant_id": "string",
        "tracking": true,
        "tracking_policy": "string",
        "created_at": "string",
        "updated_at": "string"
      }
    ],
    "cursor": "string",
    "has_more": true
  }
}