3.4 商品库存

POST

/api/v2/goods/inventory

功能说明

商品总库存，下面所有规格的库存，商品采样量、起订量、物流起订量、打包数、是否支持散件购买

应用场景

商品详情、订单预览等页面，需要显示库存的场景

注意事项

支持批量查询，最多批量查询30个

此接口返回为实时库存，数据变化比较快，库存数据仅做参考

请求参数

Header 参数

Body 参数application/json

示例

{
    "goodsId": [
        318734
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://test-openapi.7dingdong.com/api/v2/goods/inventory' \
--header 'appKey: ' \
--header 'token: ' \
--header 'nonce: ' \
--header 'timestamp: ' \
--header 'signature: ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "goodsId": [
        318734
    ]
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "status": 200,
    "msg": "请求成功",
    "requestId": "7788a33a-84a6-11f0-97ea-080027db4a40",
    "content": [
        {
            "goodsId": 280614,
            "totalStock": 11471,
            "samplingNum": 1,
            "nonPackage": 1,
            "detail": [
                {
                    "goodsId": 280614,
                    "specId": 539542,
                    "stock": 11471,
                    "packageNum": 6,
                    "moq": 1,
                    "wlMoq": 1
                }
            ]
        },
        {
            "goodsId": 318734,
            "totalStock": 99958,
            "samplingNum": 1,
            "nonPackage": 2,
            "detail": [
                {
                    "goodsId": 318734,
                    "specId": 5362984,
                    "stock": 99958,
                    "packageNum": 1,
                    "moq": 1,
                    "wlMoq": 3
                }
            ]
        }
    ]
}

修改于 2025-08-29 06:50:12

3.3 商品运输方式

3.5 全部在售商品