开放平台

发送优惠券

请求地址(POST)

https://openapi.1card1.cn/OpenApi/SendCoupon?openId=[OpenId]&signature=[Signature]&timestamp=[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://m.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时返回)

发送优惠券 调试