京东活动查询接口
3825人使用

提供联盟官方活动查询,支持分别查询联盟PC端、京粉APP、大促营销日历的活动,可查询活动链接,可将活动信息提前发布给用户。

查询的活动链接需要通过转链接口转链后方可推广使用

转链接口地址:https://www.dingdanxia.com/doc/97/94

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

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

请求参数、 调用方式 POST

参数接口

参数类型

必填

示例

说明

apikey

string

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

pageIndex

int

1

页码,默认1

pageSize

int

20

每页数量,默认20,上限50

poolId

int

1

活动物料ID,1:营销日历热门会场;2:营销日历热门榜单;6:PC站长端官方活动

activeDate

String

20200918

可查询到在这一天开始、结束、进行中的活动。可查询日期范围为查询当日的过去或未来各15天。若不传,则不限制日期

返回参数说明

标记

类型

例子

说明

total_results

long

100

总数量

id

long

1

活动ID

urlPC

String

http://pc.jd.xxx

活动落地页-PC

urlM

String

http://m.jd.xxx

活动落地页-移动端

title

String

热门

活动主题

advantage

String

满300减200

活动利益点

startTime

LONG

1532921782000

活动开始时间

endTime

LONG

1532921782000

活动结束时间

eliteId

int

1

商品资源位id,调用京粉精选商品查询接口传入此参数可获取活动SKU

recommend

int

1

推荐指数,从1到5,越高越好

downloadUrl

String

http://download/xxx

活动素材下载链接

downloadCode

String

2f435

活动素材提取码

updateTime

LONG

1532921782000

活动更新时间

content

String

双11热销

活动规则、描述、说明

tag

String

1

活动标签,1:大促活动;2:佣金提升活动;3:常规活动

actStatus

int

1

活动状态,1:未开始;2:进行中;3:已结束

promotionStartTime

LONG

1532921782000

主推开始时间

promotionEndTime

LONG

1532921782000

主推结束时间

platformType

int

1

活动推广平台,1:仅支持PC推广;2:仅支持移动端推广;3:PC和移动端均支持推广

imgList

Image[]

图片集

L image

Image

图片对象

L widthHeight

String

100*100

图片尺寸

L imgName

String

250x250.jpg

图片名称

L imgUrl

String

https://img14.360buyimg.com/pop/jfs/t1/144004/25/8645/45670/5f6210dfE9d652c78/92a00825e74ee585.jpg

图片链接

返回示例
{
	"code": 200,
	"msg": "请求成功【success】",
	"total_results": 202,
	"data": [{
		"actStatus": 3,
		"advantage": "每满100减50",
		"content": "",
		"downloadCode": "",
		"downloadUrl": "",
		"endTime": 1593532799000,
		"id": 20284,
		"platformType": 3,
		"startTime": 1592755200000,
		"tag": "",
		"title": "年中好书大盘点",
		"updateTime": 1592815636000,
		"urlM": "https://pro.m.jd.com/mall/active/46Vsus7SpKRgDbyAUitFHeBJnthu/index.html",
		"urlPC": " https://pro.jd.com/mall/active/46Vsus7SpKRgDbyAUitFHeBJnthu/index.html"
	}, {
		"actStatus": 3,
		"advantage": "满200减30",
		"content": "",
		"downloadCode": "y5fgff",
		"downloadUrl": "http://box.jd.com/sharedInfo/079BF11BB3FDBA15EEC946AFBC5707A7",
		"endTime": 1593359999000,
		"id": 20286,
		"platformType": 3,
		"startTime": 1592755200000,
		"tag": "",
		"title": "京选电器 美好生活",
		"updateTime": 1592805700000,
		"urlM": "https://pro.m.jd.com/mall/active/3YBqvgUGTqiFQYqTqxkhmaAfSVYu/index.html",
		"urlPC": " https://pro.jd.com/mall/active/3YBqvgUGTqiFQYqTqxkhmaAfSVYu/index.html"
	}]
}			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

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

4003

参数不正确

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

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

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

4009

点卡已用完

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

4010

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

需充值次数包

4011

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

需充值次数包

4012

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

将ip加入白名单

4013

联盟账号授权已过期

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

4014

PID异常

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

4015

系统异常

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

4017

请求拒绝

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