京东联盟转链API【原始转链】
1581人使用

此接口支持商品链接,活动链接,店铺链接转链

获取普通推广链接和优惠券二合一推广链接,如果出现优惠券域名host校验错误,需要把couponUrl进行Urlencode编码后再传入即可

跳转小程序信息:

京东购物小程序ID:wx91d27dbf599dff74

跳转路径:pages/union/proxy/proxy?spreadUrl=跳转短连接


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

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

请求参数、 调用方式 POST

参数接口

参数类型

必填

示例

说明

apikey

string

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

materialId

String

item.jd.com/100014577806.html

推广物料url,例如活动链接、商品链接、联盟链接(包含微信shortlink形式)、联盟商品ID(itemId)、联盟商品链接(jingfen.jd.com/detail/{itemId}.html)等;单品转链时,sceneId=2时支持入参京东主站商品ID、京东商品链接(包含3.cn单品链接);其他场景仅支持入参联盟商品ID、联盟商品链接。非单品转链不影响。

unionId

long

如果不传会走后台默认设置的,目标推客的联盟ID ,请填写自己的联盟ID 详细教程说明:https://blog.csdn.net/dayunwang/article/details/107199697

positionId

long

6

推广位ID,可自定义参数,必须为数字,不能带有特殊符合

couponUrl

String

http://coupon.jd.com/ilink/get/get_coupon.action?XXXXXXX

优惠券领取链接,在使用优惠券、商品二合一功能时入参,且materialId须为商品详情页链接 需要Urlencode

chainType

int

1

转链类型,1:长链, 2 :短链 ,3: 长链+短链,默认短链

subUnionId

String

618_18_c35***e6a

子渠道标识,您可自定义传入字母、数字或下划线,最多支持80个字符,该参数会在订单行查询接口中展示(需申请权限,申请方法请见https://union.jd.com/helpcenter/13246-13247-46301)

giftCouponKey

String

xxx_coupon_key

礼金批次号

channelId

String

12345

渠道关系ID

command

Number

1

是否生成短口令:1生成,默认不生成

weChatType

Number

1

微信小程序ShortLink类型(需向cps-qxsq@jd.com申请权限)

rid

String

435676

团长的子渠道id,由团长自定义分配。取rid的优先级:入参rid优先materialId中拼接的rid,materialId中拼接的rid优先cps链接后面拼接的rid。

sceneId

Number

1

场景ID,支持入参1,2;2需要权限申请

返回参数说明

标记

类型

例子

说明

shortURL

String

生成的推广目标链接,以短链接形式,有效期60天

clickURL

String

生成推广目标的长链,长期有效

jCommand

String

需要权限申请,京口令(匹配到红包活动有效配置才会返回京口令)

jShortCommand

String

需要权限申请,短口令

weChatShortLink

String

微信小程序ShortLink(需向cps-qxsq@jd.com申请权限)

返回示例
{
    "code": 200,
    "msg": "请求成功【success】",
    "data": {
        "clickURL": "https://union-click.jd.com/jdc?e=1000521676&p=JF8BAQgJK1olXwQFXFhdCUIVBF8IGloUXQMGUlhUCUwnRzBQRQQlBENHFRxWFlVPRjtUBABAQlRcCEBdCUoWA2oMHV0cXAEdDRsBVXt3Aih-bg9eC2VQDFc0YE0VXzIPfy5lUQoyVW5dCUoWA2oIHl4RbTYCVG4fZhFDWTsJG2sUbQYEVVZaAE8SB2kOGV8lXQ4FZIvUg56ctLqEioKk4NK034jiiXsnM2w4G1oUXAIBVFlbD3snA18LKwV7XFUEXF0IXUl5XipfEgASWFVsXVlYAEseBV8KGloXXzYyZCcnXyxDXj91fhAXVGF9MRoCfhYVa25_RzUXNHRKVg1ZdCByXxlJZi5TK1UyUW4",
        "shortURL": "https://u.jd.com/HbqP296",
        "weChatShortLink": "#小程序://京小街/qB58zo9QdzKPTlJ"
    }
}			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

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

4003

参数不正确

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

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

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

4009

点卡已用完

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

4010

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

需充值次数包

4011

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

需充值次数包

4012

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

将ip加入白名单

4013

联盟账号授权已过期

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

4014

PID异常

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

4015

系统异常

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

4017

请求拒绝

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