查询产品库存

POST

/api/v1/stock/queries

Stock

根据仓库和产品SKU列表查询详细库存信息。

所需权限： stock:read

使用场景：

ERP系统同步库存数据

电商平台查询可售库存

订单履约前检查库存可用性

库存报表和分析

请求参数

Authorization

JWT Bearer

在 Header 添加参数

Authorization

示例：

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

Body 参数application/json必填

示例

{
    "warehouseCode": "string",
    "sku": [
        "string"
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://gwms.jmalltech.com/api-gateway/api/v1/stock/queries' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "warehouseCode": "string",
    "sku": [
        "string"
    ]
}'

返回响应

🟢200成功

application/json

成功获取库存信息

Body

示例

{
    "success": true,
    "message": "Success",
    "code": "200",
    "timestamp": "2024-01-01T00:00:00Z",
    "data": [
        {
            "warehouseCode": "string",
            "sku": "string",
            "productName": "string",
            "length": 0,
            "width": 0,
            "height": 0,
            "weight": 0,
            "qualified": 0,
            "unqualified": 0,
            "details": [
                {
                    "status": "QUALIFIED",
                    "age": 0,
                    "num": 0,
                    "sku": "string"
                }
            ]
        }
    ]
}

🟠400请求有误

🟠401未认证

🟠403权限不足

🔴500服务器内部错误

修改于 2025-09-10 07:08:13

物流费试算

分页查询产品库存