京东优惠券领取情况查询接口

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

注意couponUrl需要进行Urlencode传入

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

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

请求参数、 调用方式 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

请求拒绝

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