查询产品仓库和库存分析

POST

/api/v1/products/warehouse-stocks/query

按单个商品ID查询各仓库库存明细，含仓库ID/名称、统计日期、库存数及当天全仓库库存合计；未指定仓库时每个账期额外返回一条「合计」行。 deliveryMode 默认 ALL，可选 FBS/FBO；startUpdatePeriod/endUpdatePeriod 为 yyyy-MM-dd，不传默认最近可用账期当天，最多近30天； warehouseKeyword 可按仓库名称或仓库ID筛选；一次返回区间内全部明细，不分页。

请求参数

Authorization

API Key

在 header 添加参数

Authorization

示例：

Authorization: ********************

Body 参数application/json必填

示例

{
    "itemId": 123456789,
    "deliveryMode": "ALL",
    "startUpdatePeriod": "2026-08-20",
    "endUpdatePeriod": "2026-09-02",
    "warehouseKeyword": "Коледино"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/v1/products/warehouse-stocks/query' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "itemId": 123456789,
    "deliveryMode": "ALL",
    "startUpdatePeriod": "2026-08-20",
    "endUpdatePeriod": "2026-09-02",
    "warehouseKeyword": "Коледино"
}'

返回响应

🟢200

application/json

Bodyapplication/json

示例

{
    "success": true,
    "errorCode": "string",
    "errorMessage": "string",
    "data": [
        {
            "warehouseId": 0,
            "warehouseName": "string",
            "updatePeriod": "string",
            "stock": 0,
            "totalStock": 0
        }
    ]
}

🟠400

🟠401

🟠403

🔴500

修改于 2026-09-04 07:45:16

查询店铺详情

查询产品SKU变体分析