Appearance
优惠券列表
历史版本
请求路径
- 请求方式:
POST - 请求头:
Content-Type:application/json - 接口地址:
https://gateway.nuoyunapi.com/Api/Coupon/couponList/2.0.0 - 频率限制:
10秒100次
请求参数
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| coupon_name | 否 | string | 优惠券名称(模糊搜索) |
| coupon_type | 否 | integer | 优惠券类型(1-随机立减券,2-满减券,3-折扣券,4-奖品兑换券) |
| page | 是 | integer | 页码 |
| page_size | 是 | integer | 每页数量 |
请求示例
json
{
"coupon_name": "优惠券名称",
"coupon_type": 1,
"page": 1,
"page_size": 10
}响应参数
| 参数 | 必选 | 类型 | 描述 |
|---|---|---|---|
| code | 是 | integer | 状态码:200-成功,400-失败 |
| msg | 是 | string | 提示信息 |
| data | 是 | object | 消息内容 |
data 参数结构
| 参数 | 必选 | 类型 | 描述 |
|---|---|---|---|
| total | 是 | integer | 优惠券列表总数 |
| list | 是 | array | 优惠券列表 |
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"
}
]
}
}