API文档中心

热门接口:产品ID找同款全量维权查询万能转链字符串ID转换 (有API需求可联系本站)

查询京东优惠券信息接口

调用权限:核心接口会员卡调用
接口使用场景等说明:

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

接口请求地址

环境 http 地址 https 地址
正式环境 http://api.veapi.cn/jd/couponinfo 暂无

请求方式:GETPOST

请求参数

参数名称 参数类型 必填 示例值 描述
vekey String V123M56 公共参数,接口秘钥,请在会员中心获取
couponUrls String http://coupon.jd.com/..,https://... 优惠券链接集合;上限10个。

请求示例

  • HTTP
  • PHP
  • JAVA
  • PYTHON
GET/POST  http://api.veapi.cn/jd/couponinfo?vekey=xxx&couponUrls=https%3A%2F%2Fcoupon.jd.com%2Filink%2FcouponActiveFront%2FlinkKey%2Ffront_index.action%3FlinkKey%3DAAROH_xIpeffAs_-naABEFoeweLETYj0ULXYaHD7zO6YtAqrF5a1zuYPQTRw3tIFNRDJiVT-__de6NqUPDnu4EyUb5C5nQ%26to%3Dwww.jd.com 

使用curl函数,curl不是php原生库,需要安装才能使用

$api="http://api.veapi.cn/jd/couponinfo?vekey=xxx&couponUrls=https%3A%2F%2Fcoupon.jd.com%2Filink%2FcouponActiveFront%2FlinkKey%2Ffront_index.action%3FlinkKey%3DAAROH_xIpeffAs_-naABEFoeweLETYj0ULXYaHD7zO6YtAqrF5a1zuYPQTRw3tIFNRDJiVT-__de6NqUPDnu4EyUb5C5nQ%26to%3Dwww.jd.com";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $api);
//curl_setopt($ch, CURLOPT_POST, true);  //POST方式时启用
//curl_setopt($ch, CURLOPT_POSTFIELDS, $postData );  //POST方式时传参

curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);  //如果使用https请启用
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);  //如果使用https请启用
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true );   //返回数据流,不直接输出
curl_setopt($ch, CURLOPT_ENCODING, 'gzip'); //使用gzip压缩传输让访问更快
curl_setopt($ch, CURLOPT_TIMEOUT, 6);  //允许执行的最长秒数。这里设定6S
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5);

$result = curl_exec($ch);
$info = curl_getinfo($ch);
curl_close($ch);

echo $result; //返回值
使用okhttp3/httpclient/jsoup/hutool,以hutool为例:

import cn.hutool.http.HttpResponse;
import cn.hutool.http.HttpRequest;

public class testGetParam {

    public static void main(String[] args) {
        // API网址
        String url = "http://api.veapi.cn/jd/couponinfo?vekey=xxx&couponUrls=https%3A%2F%2Fcoupon.jd.com%2Filink%2FcouponActiveFront%2FlinkKey%2Ffront_index.action%3FlinkKey%3DAAROH_xIpeffAs_-naABEFoeweLETYj0ULXYaHD7zO6YtAqrF5a1zuYPQTRw3tIFNRDJiVT-__de6NqUPDnu4EyUb5C5nQ%26to%3Dwww.jd.com";
        // JDK 8u111版本后,若目标页面为HTTPS协议,请启用proxy用户密码鉴权
        //System.setProperty("jdk.http.auth.tunneling.disabledSchemes", "");

        // 发送请求
        String result = HttpRequest.get(url)
                .timeout(10000)//设置超时,毫秒
                .execute().body();
        System.out.println(result);
    }
}
推荐使用 requests,支持访问http,https网页:

import requests
		
# 要访问的API网页
target_url = "http://api.veapi.cn/jd/couponinfo?vekey=xxx&couponUrls=https%3A%2F%2Fcoupon.jd.com%2Filink%2FcouponActiveFront%2FlinkKey%2Ffront_index.action%3FlinkKey%3DAAROH_xIpeffAs_-naABEFoeweLETYj0ULXYaHD7zO6YtAqrF5a1zuYPQTRw3tIFNRDJiVT-__de6NqUPDnu4EyUb5C5nQ%26to%3Dwww.jd.com"

# 发送请求
response = requests.get(target_url)

# 获取页面内容
if response.status_code == 200:
	print response.text

返回值(JSON)

参数名称 参数类型 是否必选 示例值 描述
takeEndTime Number 1532966460000 券领取结束时间(时间戳,毫秒)
takeBeginTime Number 1532966460000 券领取开始时间(时间戳,毫秒)
remainNum Number 9990 券剩余张数
yn String 券有效状态
num Number 10000 券总张数
quota Number 15 券消费限额
link String http://coupon.jd.com/ilink/get/get_coupon.action?XXXXXXXXXXX 券链接
discount Number 10 券面额
beginTime Number 1532966460000 券有效使用开始时间(时间戳,毫秒)
endTime Number 1532966460000 券有效使用结束时间(时间戳,毫秒)
platform String 全平台 券使用平台

返回示例

【提示】推广链接通常有时效性,示例中的链接为创建文档时生成,仅用于展示返回结果使用,有可能已失效。
{ "error": "0", "msg": "查询成功!", "data": [ { "beginTime": "1672811780000", "discount": "4.0", "endTime": "1675439999000", "link": "https://coupon.jd.com/ilink/couponActiveFront/linkKey/front_index.action?linkKey=AAROH_xIpeffAs_-naABEFoeweLETYj0ULXYaHD7zO6YtAqrF5a1zuYPQTRw3tIFNRDJiVT-__de6NqUPDnu4EyUb5C5nQ&to=www.jd.com", "num": "100000", "platform": "全平台", "quota": "5.0", "remainNum": "99745", "takeBeginTime": "1672811780000", "takeEndTime": "1675180799000", "yn": "1" } ], "request_id": "UQX6ivl" }

错误码

如果error不为0时,请点此查看错误码表格

在线
客服

会员请加QQ群交流:

微信
咨询

加微信咨询
顶部