接口地址:
http://api.web.ecapi.cn/jingdong/doPromotionCommonUrl
接口实例:
http://api.web.ecapi.cn/jingdong/doPromotionCommonUrl?apkey=登录会员中心查看&materialId=https://item.jd.com/23484023378.html&siteId=132456&sceneId=1
注意事项:如调用接口时数据返回异常,则需对接口中的【中文】及含有【空格】的数据进行Urlencode编码,然后再试。
请求方式:GET
会员范围:
全部会员 (新用户注册立刻送7天V1付费会员【注:赠送会员可使用全部接口,但调用频率与免费会员一致,免费会员调用频率可参考会员等级说明】)
必看注意:为保障接口安全及使用效率,调用本站接口前需先
添加IP白名单 (
IP地址测试),若IP不固定且无服务器,可通过“优惠推荐”中的链接购买阿里云服务器来调用接口。禁止以插件(包括但不仅限于浏览器插件及手机插件)形式使用接口,禁止将接口重新打包销售或转卖,一经发现,将做帐号封禁处理。
-
使用说明
-
-
请求参数
-
参数 |
类型 |
请求参数参考值 |
是否必须 |
说明 |
apkey |
String |
xxxxxxx |
是 |
用户中心 - 系统设置 - 平台设置 中查看APKEY密钥 (点我获取)(*必要) |
materialId |
String |
https://item.jd.com/23484023378.html |
是 |
推广物料,如链接带&符号,需要进行Urlencode编码 |
siteId |
Number |
132456 |
是 |
站点id |
positionId |
Number |
132456 |
|
推广位id |
pid |
String |
|
|
联盟子站长身份标识,格式:子站长ID_子站长网站ID_子站长推广位ID,一般用不到 |
sceneId |
String |
1 |
是 |
1、新增sceneId字段(场景ID),支持入参1,2。 2、materialId字段:单品转链时,sceneId=2时支持入参京东主站商品ID、京东商品链接(包含3.cn单品链接);其他场景仅支持入参联盟商品ID、联盟商品链接。非单品转链不影响。 |
proType |
String |
5 |
|
5:种草版二合一 |
-
返回参数
-
返回参数 |
类型 |
参数说明 |
扩展说明 |
clickURL |
String |
生成的目标推广链接,长期有效 |
长期有效 |
-
Json返回示例
-
{"code":200,"data":{"clickURL":"https://union-click.jd.com/jdc?e=&p=AyIGZRprFDJWWA1FBCVbV0IUWVALHFRBEwQAQB1AWQkrX0xQRlMleiN2VBEDAV4TcQZ6QC9IDRkOIgdWGV4XABsGVB5rEAEVAFQraxUDIkw7GmsUMhIDUB1eFwARDlwfXB0yEg9RK1sTBxIAUR5ZFR4bA10ZXRAyIjdWK2slAhI3VSsEUV9PN1caWhcA&t=W1dCFFlQCxxUQRMEAEAdQFkJ"},"msg":"数据获取成功."}
-
code/http_status说明
-
code/http_status |
说明 |
200 |
数据获取成功 |
-1 |
数据获取失败 |
401 |
IP没有添加白名单 |
429 |
访问次数超限 |
403 |
关键参数丢失 |
405 |
请求方式不对 |