淘宝联盟API
京东联盟API
拼多多API
唯品会API
开放平台API
美团联盟
电影票/肯德基
考拉海购
优惠加油
文娱直充
饿了么
点击获取APKEY

正常 查询券领用情况 接口测试

通过券的URL查询该券的信息和剩余数量

接口地址: http://api.web.ecapi.cn/suning/getCouponInfo
接口实例: http://api.web.ecapi.cn/suning/getCouponInfo?apkey=登录会员中心查看&quanUrl=https%3a%2f%2fquan.suning.com%2flqzx_recommend.do%3factivityId%3
注意事项:如调用接口时数据返回异常,则需对接口中的【中文】及含有【空格】的数据进行Urlencode编码,然后再试。
请求方式:GET
会员范围: 免费会员 (新用户注册立刻送7天V1付费会员【注:赠送会员可使用全部接口,但调用频率与免费会员一致,免费会员调用频率可参考会员等级说明】)
必看注意:为保障接口安全及使用效率,调用本站接口前需先 添加IP白名单 (IP地址测试),若IP不固定且无服务器,可通过“优惠推荐”中的链接购买阿里云服务器来调用接口。禁止以插件(包括但不仅限于浏览器插件及手机插件)形式使用接口,禁止将接口重新打包销售或转卖,一经发现,将做帐号封禁处理。
优惠推荐:高性能云服务器2折起,普惠上云,仅需234元/年 ->>立即抢购<<-

使用说明

暂无说明

请求参数

参数类型请求参数参考值是否必须说明
apkeyStringxxxxxxx用户中心 - 系统设置 - 平台设置 中查看APKEY密钥 (点我获取)*必要
quanUrlStringhttps%3a%2f%2fquan.suning.com%2flqzx_recommend.do%3factivityId%3券URL,urlencode编码
couponNumString券编码

返回参数

返回参数类型参数说明扩展说明
dataJson返回数据列表
 ├ activityIdString券活动ID
 ├ couponValueString券面额
 ├ couponCountString券总张数
 ├ couponRemainingAmountString券剩余数量
 ├ preferentialDistinctString奖励优惠说明
 ├ couponStartTimeString券的使用开始时间
 ├ couponEndTimeString券的使用结束时间
 ├ startTimeString券的领取开始时间
 ├ endTimeString券的领取结束时间
 ├ couponPlatformString券平台
 ├ isValidCouponString0代表有效1代表无效
 ├ channelIdString终端渠道31:网站、 32:移动终端、 33:云信终端、 34:电话销售、 35:电视终端、 36:WAP、 37:门店、 38:超市 39:PPTV 48:零售云APP 59:苏鲜生超市
 ├ memberAttributeListJson其他
 ├  ├ memberAttributeLimitString142000000450 :校园普通用户 142000000155 : 校园VIP F2000020 :super试用期 F20
 ├  ├ vipMemberLimitString付费会员限制1:限制 0:不限制
 ├  ├ memberLevelString会员等级161000000100:新人 161000000110:V1 161000000120:V2 161000000130

Json返回示例

{"code":200,"data":{"couponRemainingAmount":"9558","couponCount":"10000","couponValue":"5.00","couponEndTime":"2020-07-05 23:59:59","activityId":"202006240013481508","preferentialDistinct":"满30用5","couponPlatform":"C店","memberAttributeList":{"memberLevel":"","vipMemberLimit":"0","memberAttributeLimit":""},"couponStartTime":"2020-07-05 00:00:00","startTime":"2020-07-05 00:00:00","endTime":"2020-07-05 23:59:59","isValidCoupon":"0","channelId":"36,72,31,32"},"msg":"success"}

code/http_status说明

code/http_status说明
200数据获取成功
-1数据获取失败
401IP没有添加白名单
429访问次数超限
403关键参数丢失
405请求方式不对