通过unionId获取京东商品链接/活动链接/店铺链接【转链】【升级版】
6987人使用

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

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

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

跳转小程序信息:

京东购物小程序ID:wx91d27dbf599dff74

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

查看详细说明
接口地址: http://api.tbk.dingdanxia.com/jd/by_unionid_promotion 在线工具 在线测试

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

请求参数、 调用方式 GET/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

autoSearch

Boolean

true

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

type

int

1

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

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

礼金批次号

返回参数说明

标记

类型

例子

说明

shortURL

String

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

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

clickURL

String

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

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

jCommand

String

6.0复制整段话 http://JhT7V5wlKygHDK京口令内容#J6UFE5iMn***

京口令(匹配到红包活动有效配置才会返回京口令)

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%服务费

inOrderCount30Days

Number

123

30天引单量

documentInfo

String[]

段子信息

videoInfo

String[]

视频信息

返回示例
{
    "code":200,
    "msg":"请求成功【success】",
    "data":{
        "shortURL":"https://u.jd.com/nLSYwPp",
        "note":"",
        "is_coupon":0,
        "couponInfo":[
        ],
        "commissionInfo":{
            "commission":6.85,
            "commissionShare":23,
            "couponCommission":6.85,
            "endTime":32472201599000,
            "isLock":0,
            "plusCommissionShare":23,
            "startTime":1636387200000
        },
        "priceInfo":{
            "historyPriceDay":180,
            "lowestCouponPrice":29.8,
            "lowestPrice":29.8,
            "lowestPriceType":1,
            "price":29.8
        },
        "pinGouInfo":[
        ],
        "shopInfo":{
            "shopId":1000300389,
            "shopLabel":"0",
            "shopLevel":4.9,
            "shopName":"蓝漂京东自营旗舰店"
        },
        "skuName":"蓝漂 抽纸 我爱我家系列400张*24包蓝粉双色整箱装 加厚四层家用常规格白色餐巾纸面巾纸巾",
        "skuId":100019902498,
        "owner":"g",
        "inOrderCount30Days":42065,
        "imageInfo":{
            "imageList":[
                {
                    "url":"https://img14.360buyimg.com/pop/jfs/t1/137502/14/24149/149549/61a42d48E25515a6c/bd7e891f937e8985.jpg"
                },
                {
                    "url":"https://img14.360buyimg.com/pop/jfs/t1/168683/21/15357/126244/60628959E62a27177/61988085f1fa9718.jpg"
                },
                {
                    "url":"https://img14.360buyimg.com/pop/jfs/t1/176732/36/9444/95356/609dd041Ee1b336ba/88f0a7ec404f4bb4.jpg"
                },
                {
                    "url":"https://img14.360buyimg.com/pop/jfs/t1/195855/39/2963/149161/609dd041E48dbbd4e/bcbaa69942d9064b.jpg"
                },
                {
                    "url":"https://img14.360buyimg.com/pop/jfs/t1/178625/32/3951/108909/609dd042Ef6d16d7f/14bc2d4c42ebee7c.jpg"
                },
                {
                    "url":"https://img14.360buyimg.com/pop/jfs/t1/188460/24/3073/91942/609dd041E21780792/42f9b6514d1592e6.jpg"
                }
            ],
            "whiteImage":"https://img14.360buyimg.com/pop/jfs/t1/173250/9/9257/469693/609b98f5E36f6b56d/ac499ca1e13e7fa9.png"
        },
        "documentInfo":{
            "discount":"29.8?蓝漂加厚四层抽纸",
            "document":"✨这款抽纸采用了四层加厚的设计?可以更好的呵护家人的健康?让你用的更放心?纸巾的抽取式的方式?不会对宝宝造成不必要的伤害?"
        },
        "videoInfo":{
            "videoList":[
                {
                    "duration":62,
                    "high":1280,
                    "imageUrl":"https://img10.360buyimg.com/videocover/jfs/t1/204515/38/6967/77506/61447410Ed85350e3/83ffa309b46ed4b2.jpg",
                    "playType":"low",
                    "playUrl":"https://jvod.300hu.com/vod/product/47ff5657-3f52-41af-a137-948d1413a95a/11192f3c1d3c4db6b6b86f1543273456.mp4",
                    "videoType":1,
                    "width":720
                },
                {
                    "duration":62,
                    "high":1280,
                    "imageUrl":"https://img10.360buyimg.com/videocover/jfs/t1/204515/38/6967/77506/61447410Ed85350e3/83ffa309b46ed4b2.jpg",
                    "playType":"high",
                    "playUrl":"https://jvod.300hu.com/vod/product/47ff5657-3f52-41af-a137-948d1413a95a/f48765f87adf4378ae1f262422294411.mp4?source=2&h265=h265/18799/bb66d68ad2014ea7889a2e0c8d070774.mp4",
                    "videoType":1,
                    "width":720
                }
            ]
        }
    }
}

			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

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

4003

参数不正确

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

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

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

4009

点卡已用完

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

4010

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

需充值次数包

4011

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

需充值次数包

4012

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

将ip加入白名单

4013

联盟账号授权已过期

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

4014

PID异常

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

4015

系统异常

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

4017

请求拒绝

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