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:快捷型玩法模板券 | - |
└─couponTypeName | string | 使用类型名称 | |
└─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"
}'