发送优惠券
请求地址(POST)
https://openapi.1card1.cn/OpenApi/SendCoupon?openId=[OpenId]&signature=[Signature]×tamp=[TimeStamp]
字段 | 说明 |
---|---|
OpenId | 登陆开放平台生成的OpenId |
Signature | 签名=md5(OpenId+Secret+Timestamp+data),格式:32位md5大写加密 |
TimeStamp | 发起请求的时间戳,查看标准timestamp |
请求说明
data={"userAccount":"10000", "mobiles":"13800000000,13800000001", "cardIds":"0101,0102", "memberGuids":"6e67c7d4-5a68-e711-ac38-00101893930e,95010868-925d-e711-832b-0010185de866", "couponGuid":"e2876537-d43a-e711-ac38-00101893930e","sendCount":5 }
字段 | 是否必须 | 说明 |
---|---|---|
userAccount | 是 | 工号 |
mobiles | 否 | 手机号码(多个用“,”隔开,mobiles与cardIds 不能同时为空) |
cardIds | 否 | 会员卡号(多个用“,”隔开,mobiles与cardIds 不能同时为空) |
couponGuid | 是 | 优惠券唯一标识(通过“获取优惠券列表”获得“Guid”字段) |
sendCount | 是 | 发送数量 |
返回说明
成功时返回:
{"status":0,"message":"发送成功","successItems":"13800000000,0101,95010868-925d-e711-832b-0010185de866","couponSendGuid":"390A8D6C-62DA-E311-8B81-90B11C47B4DA,380A8D6C-62DA-E311-8B81-90B11C47B4DA", "couponUrl":"http://h5.yunhuiyuan.cn/Coupon/MyCoupon?bid=a08ebbfa-0ad0-e311-a603-90b11c47e695"}
失败时返回:
{"status":-1,"message":"发送失败及原因"}
字段 | 是否必须 | 说明 |
---|---|---|
status | 是 | 返回状态,全部失败时为-1,否则为true |
message | 是 | 发送结果提示语 |
successItems | 否 | 实际发送优惠券的手机号、卡号、会员Guid |
couponSendGuid | 否 | 优惠券发送记录唯一标识(此参数可以作为“核销优惠券”接口的参数) |
failItems | 否 | 发送失败的手机号或者卡号 |
failMessages | 否 | 发送失败的原因(多个原因用逗号隔开) |
couponUrl | 否 | 移动端查看我的券的地址(status=0时返回) |