卡速售2.0API - 商品列表接口

商品列表接口

#### **简要描述：**
商品列表接口

#### **请求URL：**

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

#### **请求方式：**

`POST`

#### **请求参数：**

| Header 参数 | 类型 | 是否必填 | 描述 | 示例值 |
| --- | --- | --- | --- | --- |
| Sign | string  | 是 |签名 |[ 点击查看签名规范](https://doc.kasushou.com/api/v2api/39 " 点击查看签名规范") |
| 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`

#### **返回示例：**
```json
{
    "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,
				"can_buy":"拼多多,京东,快手",
				"can_no_buy":"抖音",
				"can_price":"2.00",
				"need_balance":"2000"
            },
            {
                "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,
				"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 | 余额限价 |

</br></br></br></br>