获取营种列表
分页查询可售营种列表，用于获取 pid，再继续查营期、规格或下单。
POST/api/productList
请求参数
| 名称 | 类型 | 描述 | 是否必填 | 默认值 | 备注 |
|---|---|---|---|---|---|
| token | String | 身份校验令牌 | 必填 | - | 由 获取访问令牌 获得 |
| name | String | 营种名称 | 非必填 | - | 模糊查询 |
| pageNum | Number | 分页页码 | 非必填 | 1 | - |
| pageSize | Number | 每页条数 | 非必填 | 10 | 最大不超过 20 |
| status | Number | 公开状态 | 非必填 | - | 1 公开售卖，2 非公开售卖 |
| is_on | Number | 上下架 | 非必填 | - | 1 售卖中，2 已下架 |
| store_id | Number | 门店 ID | 非必填 | 0 | 按门店筛选营种，0 不限制；一个营种可属多个门店，取值见 获取门店清单 |
CURL
V1
curl --location --request POST 'https://open.xinduobang.cn/api/productList' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'token=YOUR_TOKEN' \
--data-urlencode 'name=' \
--data-urlencode 'pageNum=1' \
--data-urlencode 'pageSize=10'
V2（appid 为 V2 版本）
curl --location --request POST 'https://open.xinduobang.cn/api/productList' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'X-Timestamp: 1770000000' \
--header 'X-Nonce: 3f9c1a7b2e6d4058' \
--header 'X-Signature: <computed_hmac_sha256>' \
--data-urlencode 'token=YOUR_TOKEN' \
--data-urlencode 'name=' \
--data-urlencode 'pageNum=1' \
--data-urlencode 'pageSize=10'
信息
V2 签名算法及 X-Signature 计算方式见 V2 接入示例。下方接口 V2 示例均遵循相同规则，不再重复注释。
成功响应
{
"code": 0,
"msg": "success",
"data": [
{
"goods_name": "户外体育",
"pid": "24",
"is_team": 1,
"is_on": 1,
"status": 2,
"store_list": [
{ "store_id": 1, "store_name": "总部门店" },
{ "store_id": 2, "store_name": "上海分店" }
]
},
{
"goods_name": "游学天才营",
"pid": "22"
}
]
}
| 字段 | 类型 | 说明 |
|---|---|---|
| goods_name | String | 营种名称 |
| pid | String | 营种 ID |
| is_team | Number | 是否开启拼团：1 是，0 否 |
| is_on | Number | 1 售卖中，2 已下架 |
| status | Number | 1 公开售卖，2 非公开售卖 |
| store_list | Array | 该营种所属门店列表，一个营种可属于多个门店；无门店关系时为空数组 |
| store_list[].store_id | Number | 门店 ID |
| store_list[].store_name | String | 门店名称 |
失败响应
| HTTP状态码 | 错误码 | 描述 | 排查建议 |
|---|---|---|---|
| 200 | 非 0 | 业务错误 | 请检查 token 与筛选参数 |