查询频道优惠券列表

接口描述

1、查询频道优惠券列表
2、接口支持https协议

接口URL

https://api.polyv.net/live/v4/channel/coupon/list

在线API调用

请求方式

GET

接口约束

1、接口同时支持HTTP 、HTTPS ，建议使用HTTPS 确保接口安全，接口调用有频率限制，详细请查看

请求参数描述

示例

https://api.polyv.net/live/v4/channel/coupon/list?appId=frlr1zazn3&sign=012332FBD8DBCFC068AFCB484A2ADECB&timestamp=1670550787318&channelId=4854808&pageNumber=1&pageSize=10

响应参数描述

Data参数描述

Contents字段说明

Rule字段说明

Unconditional字段说明

FullReduce字段说明

Error参数描述

响应示例

系统全局错误说明详见全局错误说明

成功示例

{
  "code": 200,
  "status": "success",
  "requestId": "46c21cc2-d4da-4fe8-ae34-118c36ce99f6",
  "data": {
    "pageNumber": 1,
    "pageSize": 10,
    "totalPages": 1,
    "totalItems": 2,
    "contents": [
      {
        "couponId": "6wa8ckpjzfr1ok37j7zvhwgc3jj0wabc",
        "name": "优惠券1",
        "status": "NOT_START",
        "receiveStartTime": 1767110400000,
        "receiveEndTime": 1769788800000,
        "sort": 1,
        "rule": {
          "condition": "UNCONDITIONAL",
          "unconditional": {
            "enable": true,
            "unit": "MONEY",
            "value": 2.0
          },
          "fullReduce": {
            "enable": false,
            "unit": "MONEY",
            "full": 0.0,
            "reduce": 0.0
          },
          "limitPerPerson": -1
        },
        "useTimeType": "DAY",
        "dayOfUse": 30,
        "remainAmount": 100
      },
      {
        "couponId": "6prxllnkjqcdrcamqey7htk8hnieqabc",
        "name": "优惠券2",
        "status": "GOING",
        "receiveStartTime": 1766654100000,
        "receiveEndTime": 1769788800000,
        "sort": 2,
        "rule": {
          "condition": "UNCONDITIONAL",
          "unconditional": {
            "enable": true,
            "unit": "MONEY",
            "value": 2.0
          },
          "fullReduce": {
            "enable": false,
            "unit": "MONEY",
            "full": 0.0,
            "reduce": 0.0
          },
          "limitPerPerson": -1
        },
        "useTimeType": "DAY",
        "dayOfUse": 30,
        "remainAmount": 100
      }
    ]
  },
  "success": true
}

异常示例

{
  "code": 400,
  "status": "error",
  "requestId": "d310b70bc329403f87f77f9203d50f89.128.16360831552223589",
  "error": {
    "code": 10003,
    "desc": "时间戳过期"
  },
  "success": false
}