开放平台

获取优惠券列表

请求地址(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", "receiveMemberGroupLimit":"", "receiveMemberGroupNameLimit":"不限", }, { "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", "receiveMemberGroupLimit":"0a2efee1-d2ff-e211-b9ad-90b11c47c1da", "receiveMemberGroupNameLimit":"所有店面", } ] }

字段 是否必须 说明
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表示不限定核销张数)
receiveMemberGroupLimit 是 限领会员级别的唯一标识(注意是小写开头的驼峰命名格式)
receiveMemberGroupNameLimit 是 限领会员级别的名称(注意是小写开头的驼峰命名格式)

失败时返回:

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

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

获取优惠券列表 调试