URL: /api/assets/getCouponList

Type: POST

Content-Type: application/json; charset=utf-8

Description: 优惠卷列表查询接口

Body-parameters:

Parameter

Type

Required

Description

opfid

string

true

开放平台ID

nonce

string

true

6位随机字串不能为空

timestamp

string

true

签名时间戳

signature

string

true

签名

uid

string

true

第三方用户id

companyId

string

true

第三方公司id

pageNo

int32

true

页码

pageSize

int32

true

页容

state

string

false

券状态

ENABLE：可用

USED：已使用

EXPIRED：未过期的

INVALID：已失效

type

string

false

券类型

1:场景模板券;

2:h5品牌券;

3:一页模板券;

4:一视模板券;

5:一视品牌券;

6:h5模版券

7: 海报去水印券

8:海报模板券

9:高端创意型玩法模板券

10:互动创意型玩法模板券

11：精品型玩法模板券

12：品质型玩法模板券

13：快捷型玩法模板券

Request-body:

{
  "opfid": "30",
  "nonce": "pjr16r",
  "timestamp": "2022-05-19 14:33:20",
  "signature": "exnts7",
  "uid": "bc299ab7-4b46-4929-9bb3-7e9abd83c18c",
   "companyId": "bc299ab7-4b46-4929-9bb3-7e9abd83c18c",
  "pageNo": 923,
  "pageSize": 10,
  "state": "0nckyx",
  "type": "25hxyg"
}

Response-fields:

Field

Type

Description

Since

code

string

状态码

-

errorCode

string

错误状态码

-

msg

string

状态描述

-

data

object

数据

-

└─pageNo

int32

页码

-

└─pageSize

int32

页大小

-

└─total

int32

总数

-

└─data

array

数据

-

     └─couponId

string

优惠券ID

-

     └─couponNo

string

优惠券编号

-

     └─couponName

string

优惠券名称

-

     └─couponDesc

string

优惠券描述

-

     └─couponFilepath

string

优惠券图片

-

     └─couponReason

string

发放原因

-

     └─couponSt

string

开始使用时间，默认当前时间

-

     └─couponEt

string

结束使用使用

-

     └─couponCount

int32

使用次数限制

-

     └─couponType

int32

使用类型

1:场景模板券;

2:h5品牌券;

3:一页模板券;

4:一视模板券;

5:一视品牌券;

6:h5模版券

7: 海报去水印券

8:海报模板券

9:高端创意型玩法模板券

10:互动创意型玩法模板券

11：精品型玩法模板券

12：品质型玩法模板券

13：快捷型玩法模板券

-

     └─couponTypeNamestring使用类型名称

     └─couponUseTime

string

使用时间

-

     └─couponUseCount

int32

使用次数

-

     └─couponState

int

状态

0：可用状态

1：已使用状态

2：使用中状态

3：已过期状态

-

     └─couponRemark

string

备注

-

     └─couponCt

string

创建时间

-

Response-example:

{
  "code": "7904",
  "errorCode": "7904",
  "msg": "fmp187",
  "data": {
    "pageNo": 427,
    "pageSize": 10,
    "total": 640,
    "data": [
      {
        "couponId": "30",
        "couponNo": "ymhblg",
        "couponName": "峻熙.江",
        "couponDesc": "yd1dm9",
        "couponFilepath": "ldz8mm",
        "couponReason": "i4liwe",
        "couponSt": "2022-05-19 14:33:21",
        "couponEt": "2022-05-19 14:33:21",
        "couponCount": 340,
        "couponType": 1,
        "couponUseTime": "2022-05-19 14:33:21",
        "couponUseCount": 433,
         "couponState": 1,
        "couponRemark": "swg4ub",
        "couponCt": "2022-05-19 14:33:21",
            "couponTypeName":"场景模板券"
       }
    ]
  }
}

Curl-example:

curl -X POST -H 'Content-Type: application/json; charset=utf-8' -i /api/assets/getCouponList --data '{
  "opfid": "30",
  "nonce": "pjr16r",
  "timestamp": "2022-05-19 14:33:20",
  "signature": "exnts7",
  "uid": "bc299ab7-4b46-4929-9bb3-7e9abd83c18c",
   "companyId": "bc299ab7-4b46-4929-9bb3-7e9abd83c18c",
  "pageNo": 923,
  "pageSize": 10,
  "state": "0nckyx",
  "type": "25hxyg"
}'