京东优惠券领取情况查询接口
2499人使用

通过领券链接查询优惠券的平台、面额、期限、可用状态、剩余数量等详细信息,通常用于和商品信息一起展示优惠券券信息

注意couponUrl需要进行Urlencode传入

接口地址: http://api.tbk.dingdanxia.com/jd/coupon_query 在线测试

非大陆服务器(含港澳台)调用接口会出现网络缓慢现象,请联系客服获取国外专线接口

请求参数、 调用方式 POST

参数接口

参数类型

必填

示例

说明

apikey

string

接口秘钥,请登录后台获取

couponUrl

String

http%3a%2f%2fcoupon.m.jd.com%2fcoupons%2fshow.action%3fkey%3dadd9eccbba88469285961817ab6bb78d%26roleId%3d35097482%26to%3dmall.jd.com%2findex-10210008.html

优惠券链接 需要Urlencode

返回参数说明

标记

类型

例子

说明

takeEndTime

long

1532966460000

券领取结束时间(时间戳,毫秒)

takeBeginTime

long

1531065600000

券领取开始时间(时间戳,毫秒)

remainNum

long

9990

券剩余张数

yn

String

券有效状态

num

long

10000

券总张数

quota

double

15

券消费限额

link

String

http://coupon.jd.com/ilink/get/get_coupon.action?XXXXXXXXXXX

券链接

discount

double

10

券面额

beginTime

long

1531065600000

券有效使用开始时间(时间戳,毫秒)

endTime

long

1533052799000

券有效使用结束时间(时间戳,毫秒)

platform

String

全平台

券使用平台

返回示例
{
    "code":200,
    "msg":"请求成功【success】",
    "data":[
        {
            "beginTime":1595520000000,
            "discount":22,
            "endTime":1596211199000,
            "link":"http://coupon.m.jd.com/coupons/show.action?key=add9eccbba88469285961817ab6bb78d&roleId=35097482&to=mall.jd.com/index-10210008.html",
            "num":100000,
            "platform":"全平台",
            "quota":29,
            "remainNum":94248,
            "takeBeginTime":1595520000000,
            "takeEndTime":1596124799000,
            "yn":"是"
        }
    ]
}
			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

登录后台查看接口秘钥是否一致

4003

参数不正确

请检查参数是否符合文档要求

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

查看签名构建规则确保正确无误。

4009

点卡已用完

请登录控制台-服务购买-充值点卡

4010

请购买接口次数包才能调用此接口

需充值次数包

4011

次数包已用完,请重新购买

需充值次数包

4012

请求客户端ip未加入白名单

将ip加入白名单

4013

联盟账号授权已过期

请登录控制台【授权管理】下重新授权您的相关账号

4014

PID异常

请登录控制台【授权管理】-【淘宝授权】,检查您的推广位PID是否填写,或是否填写正确。

4015

系统异常

服务端处理异常,请等待......或联系网站在线客服反馈。

4017

请求拒绝

调用请求被拒绝,您的账号状态存在异常,请联系平台管理员解除限制。