查询库存层级列表

GET 
/openapi/2025-06/inventory_levels

分页返回库存层级列表。

请求

Query参数

inventory_item_ids string[]

库存项 ID 列表。 示例：?inventory_item_ids=1003&inventory_item_ids=1004

location_ids string[]

地点 ID 列表。 示例：?location_ids=3001&location_ids=3002

cursor string

分页游标

page_size int32

每页记录数

updated_at_min string

筛选最后更新时间不早于该时间点的库存层级；ISO 8601 格式，例如：2018-10-01T16:15:47-04:00

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object

inventory_levels object[]

库存层级列表

Array [

inventory_item_idstring

库存项 ID

location_idstring

地点 ID

stockint64

库存数量

updated_atstring

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

]

cursorstring

分页游标

has_moreboolean

是否有更多记录

示例

{
  "code": "string",
  "message": "string",
  "data": {
    "inventory_levels": [
      {
        "inventory_item_id": "string",
        "location_id": "string",
        "stock": 0,
        "updated_at": "string"
      }
    ],
    "cursor": "string",
    "has_more": true
  }
}