淘宝联盟API
京东联盟API
拼多多API
开放平台API
美团联盟
电影票/肯德基
考拉海购
优惠加油
文娱直充
饿了么
滴滴
喵有券联盟
淘宝联盟API
京东联盟API
拼多多API
开放平台API
美团联盟
电影票/肯德基
考拉海购
优惠加油
文娱直充
饿了么
滴滴
喵有券联盟
常见问题
点击获取APKEY

正常 获取商品推广链接(支持subUnionId) 接口在线测试

获取商品推广链接,支持子联盟ID(需先联系本平台进行申请)

接口地址: 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&sceneId=1
注意事项:如调用接口时数据返回异常,则需对接口中的【中文】及含有【空格】的数据进行Urlencode编码,然后再试。
请求方式:GET
会员范围: 全部会员 (新用户注册立刻送7天V1付费会员【注:赠送会员可使用全部接口,但调用频率与免费会员一致,免费会员调用频率可参考会员等级说明】)
必看注意:为保障接口安全及使用效率,调用本站接口前需先 添加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权限,因此,在联系我们申请前,请确认能否达到,避免程序开发完成后,被官方收回权限,浪费时间和精力。(此限制为京东联盟官方控制,所有第三方接口平台均受此限制,如发现某些平台限制较低,请慎重选择,以免浪费时间和精力,造成损失。)

请求参数

参数 类型 请求参数参考值 是否必须 说明
apkey String xxxxxxx 用户中心 - 系统设置 - 平台设置 中查看APKEY密钥 (点我获取)*必要
materialId String https%3a%2f%2fwqitem.jd.com%2fitem%2fview%3fsku%3d23484023378 京东商品链接或京东短链接,需要使用Urlencode进行编码,建议链接使用微Q前缀,能较好适配微信手Q页面
key_id String xxxx 联盟调用key,会员中心京东授权列表页获取
positionId Number 新增推广位id (不填的话,为其默认生成一个唯一此接口推广位-名称:微信手Q短链接)
couponUrl String 优惠券领取链接,在使用优惠券、商品二合一功能时入参,且materialId须为商品详情页链接,需进行Urlencode编码
chainType Number 3 转链类型,1:长链, 2 :短链 ,3: 长链+短链,默认短链
subUnionId String 子联盟ID
pid String 子帐号身份标识,格式为子站长ID_子站长网站ID_子站长推广位ID
autoSearch Number 1 是否启用优惠券自动搜索功能,如启用且优惠券链接未传入时,系统会自动查询优惠券
giftCouponKey String xxx_coupon_key 礼金批次号
sceneId String 1 1、新增sceneId字段(场景ID),支持入参1,2。 2、materialId字段:单品转链时,sceneId=2时支持入参京东主站商品ID、京东商品链接(包含3.cn单品链接);其他场景仅支持入参联盟商品ID、联盟商品链接。非单品转链不影响。
command String 1 是否生成短口令:1生成,默认不生成
proType String 5 5:种草版二合一

返回参数

返回参数 类型 参数说明 扩展说明
shortURL String 生成的推广目标链接,以短链接形式,有效期为半年
jCommand String 京口令(匹配到红包活动有效配置才会返回京口令)
jShortCommand String 短口令

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 数据获取失败
401 IP没有添加白名单
429 访问次数超限
403 关键参数丢失
405 请求方式不对