获取优惠券列表-GetCouponPage
功能概述
用于获取虚商发放的优惠券列表
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
Uids | List<Long> | 否 | 终端客户uid列表 | [123453242,3948483727] |
SellerId | Long | 是 | 伙伴uid | 3944837183 |
TemplateId | Long | 否 | 优惠券模版id | 295873 |
PageNo | integer | 是 | 当前页数 | 1 |
PageSize | integer | 是 | 每页记录数 | 10 |
RequestId | string | 是 | 请求id | dsnjvui9svvsd-14indw |
FromApp | string | 是 | 请求来源 | test-app |
请求示例
http(s)://resellertrade.aliyuncs.com?Action=GetCouponPage
&SellerId=153******4157
&TemplateId=202*******766
&<公共请求参数>
[
{
"fromApp":"test-app",
"pageNo":1,
"pageSize":10,
"requestId":"D95C636C-1C4D-17F0-9C4F-F3FFD17A0E07",
"sellerId":186*******259,
"uids":[
12********603,
194******38
]
}
]
返回参数
名称 | 类型 | 描述 | 示例值 |
CouponId | Long | ID | 23456 |
UserId | Long | 终端用户UID | 124523 |
Description | string | 优惠券描述 | 测试优惠券 |
CertainMoney | number | 满减条件金额,单位:元, 如满20000 | 200 |
PromotionId | Long | 优惠ID | 39*****482 |
TemplateId | Long | 模板id | 394******982 |
StartTime | string | 有效期开始时间 | 2022-03-03 12:12:00 |
EndTime | string | 有效期结束时间 | 2022-04-03 12:12:00 |
Status | string | 状态 | AVAILABLE:正常可使用 EXHAUSTED:已用完 ABANDONED:已作废 EXPIRED:已过期 |
Amount | number | 总面额(单位:元)折扣券为空 | 100 |
UsedAmount | number | 已使用金额(单位:元) | 10 |
FrozenAmount | number | 冻结金额 (单位:元) | 10 |
UsageCount | integer | 可以使用的总次数 0表示无限次使用 | 12 |
UsedCount | integer | 已使用次数(冻结次数) | 1 |
FrozenCount | integer | 冻结次数 | 1 |
SellerId | Long | 伙伴UID | 393*******722 |
DiscountRate | number | 折扣, 如:0.75 | 0.75 |
Currency | object | 货币种类 | USD |
UpperLimit | number | 优惠券上限金额 null为不限制 | null |
Count | integer | 返回总条数 | 10 |
TotalCount | integer | 符合条件的总条数,分页使用 | 100 |
RequestId | string | 用于全程跟踪, 调用传入的原路返回 | 394847372djewhv |
Success | boolean | 成功标记 | true |
Code | string | 错误码 | success |
Message | string | 错误信息 | success |
返回示例
[
{
"RequestId":"E40EC2C2-8AD5-4D01-B54C-F6F8EC176ED3",
"Data":{
"amount":20,
"bid":26888,
"certainMoney":null,
"couponId":508******69,
"couponTileHint":"Credit - $20 credit left (valid until 05/27/2017)",
"couponTitle":"Credit - $20 credit left",
"currency":"USD",
"description":"ECS Free Trial Coupon",
"discountRate":null,
"endTime":"2022-03-03 12:12:00",
"frozenAmount":0,
"frozenCount":0,
"promotionId":101******5155,
"sellerId":193******273,
"startTime":"2022-02-03 12:12:00",
"status":"AVAILABLE",
"templateId":6290,
"upperLimit":null,
"usageCount":0,
"usedAmount":0,
"usedCount":0,
"userId":5504*******6395
},
"TotalCount":106,
"Count":1,
"Success":true
}
]