简要描述:
商品列表接口
请求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": "http://img.kasushou.com/Uploads%2FAttachment%2F2022-10-25%2F63578b642b6c1.jpg", "goods_type": 2, "face_value": "2.00", "goods_price": "2.00", "status": 1, "stock_num": 9999 }, { "id": 4, "goods_name": "供货手工", "goods_img": "http://img.kasushou.com/Uploads%2FAttachment%2F2021-11-30%2F61a604627471e.jpeg", "goods_type": 2, "face_value": "1.10", "goods_price": "1.10", "status": 2, "stock_num": 1110 } ], "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 | 商品库存 |