简要描述:
商品列表接口
请求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 | 商品库存 |