自定义subUnionId获取京东商品链接/活动链接/店铺链接【新版转链】
1887人使用

此接口支持自定义参数subUnionId跟单,支持商品链接,活动链接,店铺链接转链

获取普通推广链接和优惠券二合一推广链接

传入参数 autoSearch=true 可自动查券信息


该转链接口支持跨店结算,跨店佣金100%


跳转小程序信息:

小程序ID:wx91d27dbf599dff74

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


【特别提醒】:测试调用此接口需要先联系订单侠客服申请权限方可调用成功


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

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

请求参数、 调用方式 POST

参数接口

参数类型

必填

示例

说明

apikey

string

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

materialId

String

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

商品链接、活动链接、店铺链接

autoSearch

Boolean

true

是否启用优惠券自动搜索功能,如启用且优惠券链接未传入时,系统会自动查询优惠券,并转成二合一链接,启用之后并不是所有商品都有券

type

int

1

是否保留原来券,1-默认重新查券 2-保留原来券(保留原券,不能在开启自动查券,也不会返回其他信息)

subUnionId

String

123456

自定义参数订单中透出无需申请,每个下级必须唯一,不要有中文,不要包含 逗号",",不要以partner开头,长度低于40

couponUrl

String

优惠券地址

giftCouponKey

String

礼金加密key,请先确商品是否支持礼金再传递

jy_code

String

京佣code,需联系订单侠客服获取

jy_secretkey

String

京佣secretkey,需联系订单侠客服获取

返回参数说明

标记

类型

例子

说明

shortURL

String

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

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

clickURL

String

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

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

note

String

优惠券错误:优惠券不可转链二合一,为兼容转链商品成功,去掉了优惠券

优惠券错误提示

is_coupon

int

1

是否有券 1-有 0-无

couponInfo

couponInfo

优惠券券信息

L takeEndTime

long

1532966460000

券领取结束时间(时间戳,毫秒)

L takeBeginTime

long

1531065600000

券领取开始时间(时间戳,毫秒)

L remainNum

long

9990

券剩余张数

L yn

String

券有效状态

L num

long

10000

券总张数

L quota

double

15

券消费限额

L link

String

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

券链接

L discount

double

10

券面额

L beginTime

long

1531065600000

券有效使用开始时间(时间戳,毫秒)

L endTime

long

1533052799000

券有效使用结束时间(时间戳,毫秒)

L platform

String

全平台

券使用平台

commissionInfo

CommissionInfo

佣金信息

L commission

double

22.68

佣金

L commissionShare

double

50

佣金比例

L couponCommission

double

12.68

券后佣金

L plusCommissionShare

double

50

plus佣金比例

imageInfo

ImageInfo

图片信息

L imageList

UrlInfo[]

图片合集

L url

String

http://img14.360buyimg.com/ads/jfs/t22495/56/628456568/380476/9befc935/5b39fb01N7d1af390.jpg

图片链接地址,第一个图片链接为主图链接

priceInfo

PriceInfo

价格信息

L price

double

39.9

无线价格

L lowestPrice

double

14.9

最低价格

L lowestPriceType

int

2

最低价格类型,1:无线价格;2:拼购价格; 3:秒杀价格

L lowestCouponPrice

double

10.9

最低价后的优惠券价(当商品无最优券时,不返回该字段

L historyPriceDay

int

100

历史最低价天数

pinGouInfo

PinGouInfo

拼购信息

L pingouPrice

double

39.9

拼购价格

L pingouTmCount

long

2

拼购成团所需人数

L pingouUrl

String

https://wq.jd.com/pingou_api/GetAutoTuan?sku_id=35097232463 from=cps

拼购落地页url,请勿直接使用,请用转链后的shortURL 链接

L pingouStartTime

long

1546444800000

拼购开始时间(时间戳,毫秒)

L pingouEndTime

long

1548604800000

拼购结束时间(时间戳,毫秒)

shopInfo

ShopInfo

店铺信息

shopName

String

XXXX旗舰店

店铺名称(或供应商名称)

L shopId

int

45619

店铺Id

L shopLevel

Double

3.5

店铺等级

skuId

long

26898778009

商品ID

skuName

String

便携式女士香水持久淡香小样 初见系列香水 遇见时光

商品名称

owner

String

g

g=自营,p=pop 可来判断最终分成比例 g =100%,p=90%,非自营商品官方会扣10%服务费

返回示例
{
	"code": 200,
	"msg": "请求成功【success】",
	"data": {
		"shortUrl": "https://u.jd.com/8y4Cq3",
		"clickUrl": "https://union-click.jd.com/jdc?e=&p=AyIGZRhZFAYUAl0YXxUyEgZUGFsWAhsAUxhfEgciQwpDBUoyS0IQWhkeHAxcDUQNQlZNGA5OREdcThkNXg9JHUtCCUZVV1hWC1UaWhYCEQdcHF0WBhUCQltXYXtiYiJCOFd2a1EybxJAQWUFNUMscXIUcwpnO3VbeVg1YjNydmFkF2wTbWFmXQBeOxdxZHA2bB92AEBXIlIkQnZNUTBiKH5AZn4DQz9PclRkN3w4QQFueSVEAmV2W2QWbyl1UmZzBxIvF2JyZyYaUmEAbXAhaDBRYk1jN3s4ZkdkZTV4IHZ5UHAKYzJiYXVAI28vAQBnNxZlXmB9Fg4ifl5jZxECJRscEQNODyUXVyUDIgdUGlsQBhIEVhtrVFJRQgpPGHsDFgRXT1wUAxJUVBpeHQcaDgBMDxBSRgAGGwlHUBAFUitbFTJTaVUaXhUDEgFUK1kUAxEAXB9aEwYiB1IaWhAKFw9WEl4cBiIHVBNrSFgRBlUTXBIFIjdlGGslMhIEZRhrSkZPWmUZWhQLGg%3D%3D",
		"is_coupon": 1,
		"couponInfo": [{
			"beginTime": 1600444800000,
			"discount": 100,
			"endTime": 1601135999000,
			"link": "https://coupon.m.jd.com/coupons/show.action?linkKey=AAROH_xIpeffAs_-naABEFoeJ9o8MQK0oB6sAooCPiR7DMA3BhM86W99dfV1sLrwMJgiboVcAFAt2sortEO7TofHFCy_1g",
			"num": 100000,
			"platform": "全平台",
			"quota": 129,
			"remainNum": 97445,
			"takeBeginTime": 1600444800000,
			"takeEndTime": 1601049599000,
			"yn": "是"
		}],
		"commissionInfo": {
			"commission": 6.45,
			"commissionShare": 5,
			"couponCommission": 1.45,
			"plusCommissionShare": 5
		},
		"priceInfo": {
			"lowestCouponPrice": 29,
			"lowestPrice": 129,
			"lowestPriceType": 1,
			"price": 129
		},
		"shopInfo": {
			"shopId": 10263922,
			"shopLevel": 4.5,
			"shopName": "养生堂旗舰店"
		},
		"skuName": "【官方旗舰店】养生堂维生素C咀嚼片天然vc 增强免疫力 巴西针叶樱桃 VC60片",
		"skuId": 10021218672564,
		"imageInfo": {
			"imageList": [{
				"url": "https://img14.360buyimg.com/pop/jfs/t1/111921/38/17388/178532/5f59984fE0963afb7/ead5e8bbb05238d2.jpg"
			}, {
				"url": "https://img14.360buyimg.com/pop/jfs/t1/147842/35/7617/302310/5f51eff9Ee4bad9cf/3702f519f18c393d.jpg"
			}, {
				"url": "https://img14.360buyimg.com/pop/jfs/t1/127968/11/11674/200853/5f51ed3cEf98e6ec4/3d33aa89868efdd1.jpg"
			}, {
				"url": "https://img14.360buyimg.com/pop/jfs/t1/116901/8/17174/590405/5f51ed3cE3922c983/c060c316252807fd.jpg"
			}, {
				"url": "https://img14.360buyimg.com/pop/jfs/t1/130852/40/9103/362191/5f51ed3cE3569c351/da4f66ebcb68cb14.jpg"
			}, {
				"url": "https://img14.360buyimg.com/pop/jfs/t1/131374/12/9512/281768/5f574dc9E3df91b98/29053683efc01bc8.jpg"
			}, {
				"url": "https://img14.360buyimg.com/pop/jfs/t1/117844/27/16842/299532/5f51ed3dEb0ddc569/b4532a41c2f70823.jpg"
			}, {
				"url": "https://img14.360buyimg.com/pop/jfs/t1/147186/36/7641/352002/5f51ed3dE07689d2d/37c0bc48e999bad3.jpg"
			}]
		}
	}
}			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

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

4003

参数不正确

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

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

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

4009

点卡已用完

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

4010

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

需充值次数包

4011

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

需充值次数包

4012

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

将ip加入白名单

4013

联盟账号授权已过期

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

4014

PID异常

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

4015

系统异常

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

4017

请求拒绝

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