开放平台

获取电子券列表

请求地址(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": "代金券", "CouponValue":"100", "Content": "到店有更多优惠!", "SendCount":55, "UsedCount": 34, "EndDate": "2014-08-28 16:11:45", "ImagePath":"", "UserAccount":"10002", "useStoreGuidLimit":"791acae6-36f4-e211-a8f8-0013d4497493", "sendStoreGuidLimit":"791acae6-36f4-e211-a8f8-0013d4497493", "useStoreNameLimit":"总店", "sendStoreNameLimit":"总店" }, { "Guid": "be21a368-6fcc-e211-81c9-90b11c47e696", "Title":"85折券", "TotalCount": 200, "TypeName": "折扣券", "CouponValue":"0.9", "Content": "到店有更多优惠!", "SendCount": 88, "UsedCount":54, "EndDate": "2014-08-28 16:11:45", "ImagePath":"http://files.sz1card1.com/3573/201406/201406201059062296.jpeg", "UserAccount":"10001", "useStoreGuidLimit":"", "sendStoreGuidLimit":"", "useStoreNameLimit":"所有店面", "sendStoreNameLimit":"所有店面" } ] }

字段 是否必须 说明
Guid 电子券唯一标识
Title 电子券名称
TotalCount 电子券发行总数量
TypeName 电子券类型名称
CouponValue 面值(TypeName为折扣券时表示折扣系数,为代金券时表示面值)
Content 优惠详情(请用Unicode解码)
ImagePath 形象图片
SendCount 已发送数量
UsedCount 已使用数量
EndDate 截止时间
UserAccount 截止时间
useStoreGuidLimit 电子券限制使用店面唯一标识
sendStoreGuidLimit 电子券限制发送店面唯一标识
useStoreNameLimit 电子券限制使用店面名称
sendStoreNameLimit 电子券限制发送店面名称

失败时返回:

{"status":-1,"message":"查询失败及原因"}

字段 是否必须 说明
status 状态(0,成功;-1,失败)
message 查询失败及原因

获取电子券列表 调试