API文档中心

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

京东联盟官方活动查询接口

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

提供联盟官方活动查询，支持分别查询联盟PC端、京粉APP、大促营销日历的活动，比如618，双11等大促活动。

可查询活动链接、图片、规则等素材。建议按日期依次查询当天及未来的活动。

接口请求地址

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

请求方式：GET 或 POST

请求参数

参数名称 参数类型 必填 示例值 描述
vekey String 是 V123M56 公共参数，接口秘钥，请在会员中心获取
pageIndex Number 否 1 页码，默认1
pageSize Number 否 20 每页数量，默认20，上限50
poolId Number 否 1 活动物料ID，1：营销日历热门会场；2：营销日历热门榜单；6：PC站长端官方活动
activeDate String 否 20200918 按单个日期查询活动，查询日期范围为过去或未来15天。建议按日期依次查询当天及未来的活动
needshortlink Number 否 默认0 是否对返回的活动列表转链，方便直接用于推广。可选值0，1，2，3：含义：可选值1，表示仅同步转链手机端活动会场。可选值2表示仅同步转链PC端会场。3表示同时同步转链手机端和PC端会场。0则不转链。
unionId String 是 23232323 您的京东联盟ID，在京东联盟后台获取

请求示例

  • HTTP
  • PHP
  • JAVA
  • PYTHON
GET/POST  http://api.veapi.cn/jd/activitylist?unionId=1001034551&vekey=xxx&pageIndex=1&pageSize=10
使用curl函数，curl不是php原生库，需要安装才能使用

$api="http://api.veapi.cn/jd/activitylist?unionId=1001034551&vekey=xxx&pageIndex=1&pageSize=10";

$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/activitylist?unionId=1001034551&vekey=xxx&pageIndex=1&pageSize=10";
        // 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/activitylist?unionId=1001034551&vekey=xxx&pageIndex=1&pageSize=10"

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

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

返回值（JSON）

参数名称 参数类型 是否必选 示例值 描述
title String 否 热门 活动主题
advantage String 否 满300减200 活动利益点
startTime Number 否 1532921782000 活动开始时间
endTime Number 否 1532921782000 活动结束时间
eliteId Number 否 1 商品资源位id，调用京粉精选商品查询接口传入此参数可获取活动SKU
recommend Number 否 1 推荐指数，从1到5，越高越好
downloadUrl String 否 http://download/xxx 活动素材下载链接
downloadCode String 否 2f435 活动素材提取码
updateTime Number 否 1532921782000 活动更新时间
content String 否 双11热销 活动规则、描述、说明
tag String 否 1 活动标签，1：大促活动；2：佣金提升活动；3：常规活动
actStatus Number 否 1 活动状态，1：未开始；2：进行中；3：已结束
promotionStartTime Number 否 1532921782000 主推开始时间
promotionEndTime Number 否 1532921782000 主推结束时间
platformType Number 否 1 活动推广平台，1：仅支持PC推广；2：仅支持移动端推广；3：PC和移动端均支持推广
imgList Map 否   图片集
 └─ widthHeight String 否 100*100 图片尺寸
 └─ imgName String 否 250x250.jpg 图片名称
 └─ imgUrl String 否 https://img14.360buyimg.com/pop/jfs/t1/144004/25/8645/45670/5f6210dfE9d652c78/92a00825e74ee585.jpg 图片链接
id Number 否 1 活动ID
categoryList Map 否   类目集
 └─ categoryId Number 否 652 类目Id
 └─ type Number 否 1 类目级别(需枚举，当前京挑客活动全部为一级类目)
urlPC String 否 http://pc.jd.xxx 活动落地页-PC
urlM String 否 http://m.jd.xxx 活动落地页-移动端
urlPC_short String 否 https://u.jd.com/t8avI0d 活动落地页-PC端推广链接，仅needshortlink入参值为2或3时，才有该字段。
urlM_short String 否 https://u.jd.com/tbagSfU 活动落地页-移动端推广链接，仅needshortlink入参值为1或3时，才有该字段。
totalCount Number 否 100 总数量

返回示例

【提示】推广链接通常有时效性，示例中的链接为创建文档时生成，仅用于展示返回结果使用，有可能已失效。
{ "error": "0", "msg": "查询成功！", "data": [ { "actStatus": "3", "advantage": "每满300减40", "categoryList": [ { "categoryId": "15248", "type": "1" }, { "categoryId": "6196", "type": "1" }, { "categoryId": "737", "type": "1" }, { "categoryId": "9847", "type": "1" }, { "categoryId": "9855", "type": "1" } ], "downloadCode": "", "downloadUrl": "", "endTime": "1672588799000", "id": "129754", "imgList": [ { "imgName": "100x100.png", "imgUrl": "https://img14.360buyimg.com/pop/jfs/t1/65460/19/19965/23066/63a9aeabEfb167e25/e4939590d58edca4.png", "widthHeight": "100*100" }, { "imgName": "630x260.png", "imgUrl": "https://img14.360buyimg.com/pop/jfs/t1/130730/40/34134/310582/63a9a827E55773387/c03731337cc2ea24.png", "widthHeight": "630*260" }, { "imgName": "600x225.png", "imgUrl": "https://img14.360buyimg.com/pop/jfs/t1/221933/35/17771/259209/63a9a827Eb67db6ce/a3a1e168c7af338c.png", "widthHeight": "600*225" }, { "imgName": "350x350.png", "imgUrl": "https://img14.360buyimg.com/pop/jfs/t1/781/9/20286/259244/63a9a827E2502c017/a0d3ef2c6ac1f4a7.png", "widthHeight": "350*350" }, { "imgName": "320x360.png", "imgUrl": "https://img14.360buyimg.com/pop/jfs/t1/102958/24/29463/228144/63a9a827F23ff4ebb/1410645130b16cfc.png", "widthHeight": "320*360" }, { "imgName": "1080x430.png", "imgUrl": "https://img14.360buyimg.com/pop/jfs/t1/221624/3/21737/764370/63a9a826E420aee85/59b0071ab7db83b4.png", "widthHeight": "1080*430" } ], "platformType": "3", "startTime": "1672156800000", "tag": "3", "title": "家电家居一站购", "updateTime": "1672490874000", "urlM": "https://pro.m.jd.com/mall/active/5tgghX82dkiVxT5Rm4RQbgv53p8/index.html", "urlPC": "https://pro.jd.com/mall/active/5tgghX82dkiVxT5Rm4RQbgv53p8/index.html", "urlM_short": "https://u.jd.com/tzaGvHl", "urlPC_short": "https://u.jd.com/t8abo4u" } ], "totalCount": "11832", "request_id": "ulH85wz" }

错误码

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

在线
客服

点此【QQ在线咨询】QQ号：3252444923

会员请加QQ群交流：

微信
咨询

加微信咨询
顶部