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

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

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

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

跳转小程序信息:

小程序ID:wx91d27dbf599dff74

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



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

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

请求参数、 调用方式 GET/POST

参数接口

参数类型

必填

示例

说明

apikey

string

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

materialId

String

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

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

unionId

long

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

autoSearch

Boolean

true

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

positionId

long

6

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

couponUrl

String

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

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

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

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

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

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

商品名称

返回示例
{
    "code":200,
    "msg":"请求成功【success】",
    "data":{
        "shortURL":"https://u.jd.com/FT5lvH",
        "is_coupon":1,
        "couponInfo":[
            {
                "beginTime":1593446400000,
                "discount":40,
                "endTime":1596470399000,
                "link":"https://coupon.m.jd.com/coupons/show.action?linkKey=AAROH_xIpeffAs_-naABEFoeIb7wwUdNbWC9hHy8Ffz6795qYxm_YG9FM0whY_XNLlv0fTBYedW3BF4VuTcpeMkEFFAKHQ",
                "num":100000,
                "platform":"全平台",
                "quota":129,
                "remainNum":99757,
                "takeBeginTime":1593446400000,
                "takeEndTime":1596211199000,
                "yn":"是"
            }
        ],
        "commissionInfo":{
            "commission":25.69,
            "commissionShare":15.2,
            "couponCommission":19.61,
            "plusCommissionShare":15.2
        },
        "priceInfo":{
            "historyPriceDay":35,
            "lowestCouponPrice":129,
            "lowestPrice":169,
            "lowestPriceType":1,
            "price":169
        },
        "shopInfo":{
            "shopId":1000004205,
            "shopLevel":4.9,
            "shopName":"华光电器京东自营旗舰店"
        },
        "skuName":"华光(HG)手持蒸汽挂烫机家用小家电 电熨斗 便捷熨衣服机 迷你旅行出差熨烫机 QH09奶咖色",
        "skuId":100007926326,
        "imageInfo":{
            "imageList":[
                {
                    "url":"http://img14.360buyimg.com/ads/jfs/t1/140176/34/3494/84521/5f17e81aE830f8e60/112d592dd418d3d5.jpg"
                },
                {
                    "url":"http://img14.360buyimg.com/ads/jfs/t1/130680/32/5080/80732/5f17e81bE92b878ad/555ff8f50c5d7385.jpg"
                },
                {
                    "url":"http://img14.360buyimg.com/ads/jfs/t1/144204/24/3531/123045/5f17e81bEc2aa25ae/5ab5b6163f42ddba.jpg"
                },
                {
                    "url":"http://img14.360buyimg.com/ads/jfs/t1/146499/22/3472/97410/5f17e81aE67a15732/e775ca03ddbdcb12.jpg"
                },
                {
                    "url":"http://img14.360buyimg.com/ads/jfs/t1/131557/21/4981/95483/5f17e81bEbd1a2287/62dfbbe3210533bf.jpg"
                },
                {
                    "url":"http://img14.360buyimg.com/ads/jfs/t1/120975/32/7824/87292/5f17e81bE096e8573/93a3bd277afd61e4.jpg"
                },
                {
                    "url":"http://img14.360buyimg.com/ads/jfs/t1/122419/5/7834/63107/5f17e81bE93e93e0c/d9f5877dfea8ae47.jpg"
                },
                {
                    "url":"http://img14.360buyimg.com/ads/jfs/t1/113309/38/12882/64275/5f17e81bEf332ed6e/1bb30e62fb06d443.jpg"
                },
                {
                    "url":"http://img14.360buyimg.com/ads/jfs/t1/131673/10/5058/105116/5f17e81bE9bf26443/039d797ae752d79d.jpg"
                },
                {
                    "url":"http://img14.360buyimg.com/ads/jfs/t1/122766/1/7680/75845/5f17e830Ecfde3b0a/4c5a829c25b9f6f0.jpg"
                }
            ]
        }
    }
}
			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

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

4003

参数不正确

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

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

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

4009

点卡已用完

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

4010

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

需充值次数包

4011

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

需充值次数包

4012

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

将ip加入白名单

4013

联盟账号授权已过期

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

4014

PID异常

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

4015

系统异常

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