开放平台

获取优惠券列表

请求地址(POST)

https://openapi.1card1.cn/OpenApi/Get_CouponPagedV2?openId=[OpenId]&signature=[Signature]&timestamp=[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 查询失败及原因

获取优惠券列表 调试