淘宝客API
京东API
拼多多API
唯品会API
苏宁API
开放平台API
美团平台
考拉海购
点击获取APKEY

正常 获取商品推广链接(支持subUnionId)

更新时间:2020-11-30 17:19:08

请求链接: http://api.web.ecapi.cn/jingdong/doItemCpsUrl
请求实例: http://api.web.ecapi.cn/jingdong/doItemCpsUrl?apkey=登录会员中心查看&materialId=https%3a%2f%2fwqitem.jd.com%2fitem%2fview%3fsku%3d23484023378&key_id=xxxx (注:此实例中的密钥为登录用户的真实密钥,不登录不显示,请妥善保管,切勿泄露!)
注意事项:如调用接口时数据返回异常,则需对接口中的【中文】及含有【空格】的数据进行Urlencode编码,然后再试。
会员限制: 全部会员 (新用户注册立刻送7天V1付费会员【注:赠送会员可使用全部接口,但调用频率与免费会员一致,免费会员调用频率可参考会员等级说明】)
频率说明: 不同会员级别调用频率不同,具体可见会员升级页面介绍。会员升级传送门
使用说明: 获取商品推广链接,支持子联盟ID(需先联系本平台进行申请)
必看注意:为保障接口安全及使用效率,调用本站接口前需先 添加IP白名单 (IP地址测试),若IP不固定且无服务器,可通过“优惠推荐”中的链接购买阿里云服务器来调用接口。禁止以插件(包括但不仅限于浏览器插件及手机插件)形式使用接口,禁止将接口重新打包销售或转卖,一经发现,将做帐号封禁处理。
优惠推荐:高性能云服务器2折起,普惠上云,仅需234元/年 ->>立即抢购<<-

使用说明

变更说明:

传入参数取消unionId参数,改为传入key_id,即京东联盟调用key

传入优惠券链接后,如接口返回:

{"code":-1,"data":{"code":2001901,"message":"优惠券域名host校验错误","requestId":"21922_0b12a2f1_k334xt8w_56585446"},"msg":"优惠券域名host校验错误"}

或类似提示时,只需要将优惠券链接进行Urlencode编码后再传入即可

申请subUnionId说明:(子联盟ID是可选参数,申请权限之后可以用,没有申请的直接忽略这个参数即可)

京东官方要求申请subUnionId后,2个月内日均订单量需要达到500,达不到将收回子联盟ID权限,因此,在联系我们申请前,请确认能否达到,避免程序开发完成后,被官方收回权限,浪费时间和精力。(此限制为京东联盟官方控制,所有第三方接口平台均受此限制,如发现某些平台限制较低,请慎重选择,以免浪费时间和精力,造成损失。)

请求参数

参数类型请求参数参考值是否必须说明
apkeyStringxxxxxxx用户中心 - 系统设置 - 平台设置 中查看APKEY密钥 (点击进入)*必要
materialIdStringhttps%3a%2f%2fwqitem.jd.com%2fitem%2fview%3fsku%3d23484023378京东商品链接或京东短链接,需要使用Urlencode进行编码,建议链接使用微Q前缀,能较好适配微信手Q页面
key_idStringxxxx联盟调用key,会员中心京东授权列表页获取
positionIdNumber新增推广位id (不填的话,为其默认生成一个唯一此接口推广位-名称:微信手Q短链接)
couponUrlString优惠券领取链接,在使用优惠券、商品二合一功能时入参,且materialId须为商品详情页链接,需进行Urlencode编码
chainTypeNumber3转链类型,1:长链, 2 :短链 ,3: 长链+短链,默认短链
subUnionIdString子联盟ID
pidString子帐号身份标识,格式为子站长ID_子站长网站ID_子站长推广位ID
autoSearchNumber1是否启用优惠券自动搜索功能,如启用且优惠券链接未传入时,系统会自动查询优惠券
giftCouponKeyStringxxx_coupon_key礼金批次号

返回参数

返回参数类型参数说明扩展说明
shortURLString生成的推广目标链接,以短链接形式,有效期为半年

Json返回示例

{"code":200,"data":{"shortURL":"https://u.jd.com/jsxxxxxeu","clickURL":"https://union-click.jd.com/jdc?e=40000&p=AyIxxxxxZUGVk="},"msg":"success"}

code/http_status说明

code/http_status说明
200数据获取成功
-1数据获取失败
401IP没有添加白名单
429访问次数超限
403关键参数丢失
405请求方式不对