商品列表接口

简要描述：

商品列表接口

请求URL：

http(s)://域名/api/v1/goods/list

请求方式：

POST

请求参数：

Header 参数	类型	是否必填	描述	示例值
Sign	string	是	签名	点击查看签名规范
Timestamp	string	是	13位时间戳（毫秒）	1696644296195
UserId	string	是	您的用户接口appid	2uIkTrXNdAFc7OKhbRenzjDtgPoZ6s5C

Body 参数	类型	是否必填	描述	示例值
cate_id	int	否	二级分类ID	0
keyword	string	否	商品名称
limit	int	否	每页数量（为空默认为100条）	100
page	int	否	当前页码（为空默认为第1页）	1

签名示例：

1696654563249{"cate_id":0,"keyword":"","limit":100,"page":1}e3yw37fe2zhb4wb6p2zzmxerpr835pjy

返回示例：

{
    "code": 200,
    "msg": "成功",
    "data": {
        "list": [
            {
                "id": 2909,
                "goods_name": "test自营手工",
                "goods_img": "https://img.hmxn.cc/images/2025/07/28/0c1bd0c40657.jpg",
                "goods_type": 2,
                "face_value": "2.00",
                "goods_price": "2.00",
                "status": 1,
                "stock_num": 9999,
                "can_buy":"拼多多,京东,快手",
                "can_no_buy":"抖音",
                "can_price":"2.00",
                "need_balance":"2000"
            },
            {
                "id": 4,
                "goods_name": "供货手工",
                "goods_img": "https://img.hmxn.cc/images/2025/07/28/0c1bd0c40657.jpg",
                "goods_type": 2,
                "face_value": "1.10",
                "goods_price": "1.10",
                "status": 2,
                "stock_num": 1110,
                "can_buy":"拼多多,京东,快手",
                "can_no_buy":"抖音",
                "can_price":"2.00",
                "need_balance":"2000"
            }
        ],
        "total": 2
    }
}

返回data说明：

参数名	类型	描述
list	array	商品列表数据
total	int	获取到的商品总数量

返回list说明：

参数名	类型	描述
id	int	商品ID
goods_name	string	商品名称
goods_img	string	商品图片
goods_type	int	商品类型：1=卡密商品,2=虚拟商品
face_value	string	商品面值
goods_price	string	商品价格
status	int	商品状态：1=销售,2=暂停,3=禁售
stock_num	int	商品库存
can_buy	string	可售渠道
can_no_buy	string	禁售渠道
can_price	string	销售限价
need_balance	string	余额限价

商品列表接口

简要描述：

请求URL：

请求方式：

请求参数：

签名示例：

返回示例：

返回data说明：

返回list说明：

联系我们

400-696-1187