Appearance
优惠券列表
接口路径
- 请求方式:
POST - 请求头:
Content-Type:application/json - 接口地址:
/Third/Coupon/couponList - 频率限制:
10秒100次
请求参数
| 参数名 | 类型 | 必填 | 说明 | 示例值 |
|---|---|---|---|---|
| coupon_name | string | 否 | 优惠券名称(模糊搜索) | 满减 |
| type | integer | 否 | 优惠券类型搜索(1-随机立减券,2-满减券,3-折扣券,4-奖品兑换券) | 1 |
| page | integer | 否 | 页码 | 1 |
| page_size | integer | 否 | 每页数量 | 10 |
请求示例
json
{
"coupon_name": "优惠券名称",
"type": 1,
"page": 1,
"page_size": 10
}响应参数
| 参数 | 必选 | 类型 | 描述 |
|---|---|---|---|
| code | 是 | integer | 响应码 |
| msg | 是 | string | 响应信息 |
| data | 是 | object | 消息内容 |
data 参数结构
| 参数 | 必选 | 类型 | 描述 |
|---|---|---|---|
| total | 是 | integer | 优惠券列表总数 |
| list | 是 | object[] | 优惠券列表 |
list 参数结构
| 参数 | 必选 | 类型 | 描述 |
|---|---|---|---|
| id | 是 | integer | 优惠券id |
| name | 是 | string | 优惠券名称 |
| type | 是 | integer | 优惠券类型(1-随机立减券,2-满减券,3-折扣券,4-奖品兑换券) |
| status | 是 | integer | 优惠券状态(1进行中,2停止中,3未开始,4已失效,5已删除) |
| free_stock | 是 | integer | 免费渠道库存 |
| total_number | 是 | integer | 优惠券总数量 |
| receive | 是 | integer | 已领取数量 |
| promotion_content | 是 | string | 优惠内容 |
| time_limit_content | 是 | string | 优惠券使用时间 |
响应示例
json
{
"code": 200,
"msg": "success",
"data": {
"total": 166,
"list": [
{
"id": 2375,
"name": "11",
"type": 4,
"status": 1,
"free_stock": 11,
"total_number": 11,
"receive": 0,
"promotion_content": "免费领取,线下核销",
"time_limit_content": "2025.05.08-2025.05.09"
}
]
}
}