获取优惠券列表
请求地址(POST)
https://openapi.1card1.cn/OpenApi/Get_CouponPagedV2?openId=[OpenId]&signature=[Signature]×tamp=[TimeStamp]
字段 | 说明 |
---|---|
OpenId | 登陆开放平台生成的OpenId |
Signature | 签名=md5(OpenId+Secret+Timestamp+data),格式:32位md5大写加密 |
TimeStamp | 发起请求的时间戳,查看标准timestamp |
请求说明
data={"userAccount":"10003","where":" 1=1 ", "pageIndex":0,"pageSize":10,"orderBy":" CreateTime desc "}
字段 | 是否必须 | 说明 |
---|---|---|
userAccount | 是 | 工号 |
where | 否 | 查询条件 |
pageIndex | 是 | 页码 |
pageSize | 是 | 页大小 |
orderBy | 否 | 排序规则 |
返回说明
成功时返回:
{ "status":0, "total":2, "data":[ { "Guid": "a13ea1b4-3fe6-e311-8b81-90b11c47b4da", "Title":"10元代金券", "TotalCount": 100, "TypeName": "代金券", "CustomizeTypeName": "系统默认", "CouponValue":"100", "MinConsumeValue":"1000", "Content": "到店有更多优惠!", "SendCount":55, "UsedCount": 34, "EndDate": "2014-08-28 16:11:45", "CreateTime":"2014-01-01 12:00:00", "ModifiedTime":"2014-01-01 12:00:00", "ImagePath":"", "UserAccount":"10002", "useStoreGuidLimit":"791acae6-36f4-e211-a8f8-0013d4497493", "sendStoreGuidLimit":"791acae6-36f4-e211-a8f8-0013d4497493", "useStoreNameLimit":"总店", "sendStoreNameLimit":"总店", "StartDateTime": null, "EndDateTime": null, "DelayDays": 5, "DurationDays": 10, "goodsItemGuidLimit":"801acae6-36f4-e211-a8f8-0013d4497493", "goodsItemTypeGuidLimit":null, "limitType":"1", "LimitPerType":"0" "SSUseLimitNum":"0" }, { "Guid": "be21a368-6fcc-e211-81c9-90b11c47e696", "Title":"85折券", "TotalCount": 200, "TypeName": "折扣券", "CustomizeTypeName": "新店开业类", "CouponValue":"0.9", "MinConsumeValue":"1000", "Content": "到店有更多优惠!", "SendCount": 88, "UsedCount":54, "EndDate": "2014-08-28 16:11:45", "CreateTime":"2014-01-01 12:00:00", "ModifiedTime":"2014-01-01 12:00:00", "ImagePath":"http://files.sz1card1.com/3573/201406/201406201059062296.jpeg", "UserAccount":"10001", "useStoreGuidLimit":"", "sendStoreGuidLimit":"", "useStoreNameLimit":"所有店面", "sendStoreNameLimit":"所有店面", "StartDateTime": "2017-05-18 00:00:00", "EndDateTime": "2017-05-31 23:59:59", "DelayDays": null, "DurationDays": 0, "goodsItemGuidLimit":null, "goodsItemTypeGuidLimit":"0a2efee1-d2ff-e211-b9ad-90b11c47c1da", "limitType":"3", "LimitPerType":"1" "SSUseLimitNum":"1" } ] }
字段 | 是否必须 | 说明 |
---|---|---|
Guid | 是 | 优惠券唯一标识 |
Title | 是 | 优惠券名称 |
TotalCount | 是 | 优惠券发行总数量 |
TypeName | 是 | 优惠券类型名称 |
CustomizeTypeName | 是 | 所属类别(商家自定义优惠券类别) |
CouponValue | 是 | 面值(TypeName为折扣券时表示折扣系数,为代金券时表示面值) |
MinConsumeValue | 是 | 最低消费金额 |
Content | 是 | 优惠详情(请用Unicode解码) |
ImagePath | 是 | 形象图片 |
SendCount | 是 | 已发送数量 |
UsedCount | 是 | 已核销数量 |
EndDate | 是 | 有效期描述 |
CreateTime | 是 | 创建时间 |
ModifiedTime | 是 | 最近更新时间 |
UserAccount | 是 | 创建者 |
useStoreGuidLimit | 是 | 优惠券限制核销店面唯一标识 |
sendStoreGuidLimit | 是 | 优惠券限制发送店面唯一标识 |
useStoreNameLimit | 是 | 优惠券限制核销店面名称 |
sendStoreNameLimit | 是 | 优惠券限制发送店面名称 |
StartDateTime | 是 | 起始时间(不为空时,与EndDateTime组合表示有效期) |
EndDateTime | 是 | 截止时间(不为空时,与StartDateTime组合表示有效期) |
DelayDays | 是 | 不为空且时,与DurationDays组合表示 从下发第DelayDays日起,DurationDays内可用 |
DurationDays | 是 | 不为空且大于0时,与DelayDays组合表示 从下发第DelayDays日起,DurationDays内可用 |
goodsItemGuidLimit | 是 | 限定使用消费项目唯一标识 |
goodsItemTypeGuidLimit | 是 | 限定使用消费项目类别唯一标识 |
limitType | 是 | 限定类型(0:未限定,1:限定消费项目可用,2:限定消费项目不可用,3:限定消费项目类别可用,4:限定消费项目类别不可用) |
LimitPerType | 是 |
限定核销周期,与SSUseLimitNum共同生效(LimitPerType周期内,限用SSUseLimitNum张) LimitPerType=0表示不限周期,5 表示每天,4表示每周,3表示每月 |
SSUseLimitNum | 是 | 限定核销数量,与LimitPerType共同生效(LimitPerType周期内,限用SSUseLimitNum张,SSUseLimitNum=0表示不限定核销张数) |
失败时返回:
{"status":-1,"message":"查询失败及原因"}
字段 | 是否必须 | 说明 |
---|---|---|
status | 是 | 状态(0,成功;-1,失败) |
message | 是 | 查询失败及原因 |