通过unionId获取京东商品/活动推广链接
9180人使用

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


注意:couponUrl进行Urlencode编码后再传入


此接口可将以下活动进行转链推广

618年中大促领券汇总

https://u.jd.com/yfA4Dk 运动户外活动日

https://u.jd.com/iUXe20 京东旅行日

https://u.jd.com/aqdSGX 全品券105-5限量

https://u.jd.com/0qXdNa 会员Plus礼金

https://u.jd.com/OA6Kmw 抽618支付红包和还款券

https://u.jd.com/XVPAkx 家电每满300-40好券

https://u.jd.com/q81h8O 京喜百亿补贴每天限购一次

https://u.jd.com/Qn7sE9 食品饮料好券还有支付券必领

https://u.jd.com/vy1Yjz 京东618大促主会场领49-2支付券

https://u.jd.com/jgOySF 清洁品类好券

https://u.jd.com/lF7IJZ 手机618券

https://u.jd.com/3hzO8f 京东618活动排期

https://u.jd.com/qW3DZv 空调618超前抢领券

https://u.jd.com/hpQSYz 图书618会场

https://u.jd.com/qyiMyZ 洗衣机618提前抢

https://u.jd.com/1wkX8B 新全品支付券

https://u.jd.com/BStlRD 消费补贴券

https://u.jd.com/zQgLLd 福利金兑换全品券

https://u.jd.com/bJxXzU 全品白条49-3

https://u.jd.com/21w5oO 两张全品白条支付券

https://u.jd.com/yPBWmW 食品券

https://u.jd.com/MGri6S 京东快递券

https://u.jd.com/Nzm8CZ 火车票券

https://u.jd.com/RdDHcp 话费券



接口地址: http://api.tbk.dingdanxia.com/jd/by_unionid_promotion 在线测试
请求参数、 调用方式 GET/POST

参数接口

参数类型

必填

示例

说明

apikey

string

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

signature

string

接口签名,查看创建规则,(可在后台开启或关闭,关闭状态可不需要此参数)

materialId

String

https://item.jd.com/100007926326.html

商品链接url

unionId

long

1000141445

目标推客的联盟ID 获取地址:https://union.jd.com/user

positionId

long

6

新增推广位id (不填的话,为其默认生成一个唯一此接口推广位-名称:微信手Q短链接) 获取地址:https://union.jd.com/manager/promotionSite 推广位ID

pid

String

618_618_6018

子帐号身份标识,格式为子站长ID_子站长网站ID_子站长推广位ID 和淘宝pid不一样 可以不填 positionId为推广位

couponUrl

String

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

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

subUnionId

String

618_18_c35***e6a

子联盟ID(需申请,申请方法请见https://union.jd.com/helpcenter/13246-13247-46301),该字段为自定义参数,建议传入字母数字和下划线的格式

chainType

int

1

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

返回参数说明

标记

类型

例子

说明

shortURL

String

https://union-click.jd.com/jdc?d=XXXXXX

生成的推广目标链接,以短链接形式,有效期为半年

clickURL

String

https://union-click.jd.com/jdc?e=XXXXXX%26p=XXXXXXXXXXX

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

返回示例
{
	"code": 200,
	"msg": "请求成功【success】",
	"data": {
		"clickURL": "https:\/\/union-click.jd.com\/jdc?e=1000521676&p=AyIGZRprFQMTBlQZXhMBFwFQKx9KWkxYZUIeUENQDEsFA1BWThgOTkRHXE4ZVRpaFAMQAlMYXhMHDV4QRwYlUhZYNXhdYXlwcg1dX0BaEQFUTRBtRB4LZRprFQMTBlUeWxAHFjdlG1slVHwHVBpaFAMSB1ceaxQyEgNTG1sXAhIGVxldHTISD1IrjpyJx4zizteE26O6ga3Qw72TN2UrWCUCEwZUH1gVBRQAZStbJQIiWBFGBiUAEwZXGQ%3D%3D",
		"shortURL": "https:\/\/u.jd.com\/9wVFFk"
	}
}			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

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

4003

参数不正确

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

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

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

4009

点卡已用完

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

4010

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

需充值次数包

4011

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

需充值次数包

4012

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

将ip加入白名单

4013

联盟账号授权已过期

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

4014

PID异常

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