3.1 商品列表

POST

/api/v1/goods/goods_list

功能说明

商品列表，返回所有上架的商品

应用场景

首次对接时，可通过此接口获取对外开放的所有商品

注意事项

初始化商品数据时，可通过此接口获取所有在售的商品，以业务系统支持的数据结构进行存储

请求参数

Header 参数

Body 参数application/json

示例

{
    "goods": {
        "goodsId":279516,
        "goodsName":"爱车帮",
        "cateId1":7,
        "cateId2":48,
        "brandId":300,
        "discount": 1,
        "goodsType":1
    },
    "pagination": {
        "page":1,
        "pageSize":10
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://test-openapi.7dingdong.com/api/v1/goods/goods_list' \
--header 'appKey;' \
--header 'token;' \
--header 'nonce;' \
--header 'timestamp;' \
--header 'signature;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "goods": {
        "goodsId":279516,
        "goodsName":"爱车帮",
        "cateId1":7,
        "cateId2":48,
        "brandId":300,
        "discount": 1,
        "goodsType":1
    },
    "pagination": {
        "page":1,
        "pageSize":10
    }
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "status": 200,
    "msg": "请求成功",
    "requestId": "049784a4-390c-11ef-8c46-08002763b2f5",
    "content": {
        "total": 1,
        "currentPage": 1,
        "perPage": 10,
        "count": 1,
        "items": [
            {
                "goodsId": 279516,
                "goodsName": "J-爱车帮 车载型吸尘器便捷手执式全方位干湿两用大功率超大吸力 新疆 西藏 甘肃 宁夏 青海 海南 内蒙古 不发货 （20个/箱 整箱起发）",
                "cateId1": 7,
                "cateId2": 48,
                "brandId": 300,
                "discount": 0.71,
                "marketPrice": 46900,
                "defaultSpecId": 538020,
                "closeStatus": 0,
                "onOffStatus": 1,
                "goodsType": 1,
                "volume": 0,
                "weight": 1000,
                "defaultImage": "http://csstatics.7dingdong.com/data/files/goods/20240514/small_66431490c3523.jpg",
                "specialInvoice": 2,
                "goodsUnit": "件",
                "samplingNum": 100,
                "video": "",
                "videoThumbnail": "",
                "videoIntro": ""
            }
        ]
    }
}

修改于 2024-07-03 12:33:31

2.5 所有运输方式

3.2 商品详情