API文档中心

热门接口:产品ID找同款全量维权查询万能转链字符串ID转换 (有API需求可联系本站)

通过unionId获取推广链接(支持产品、店铺、大促活动、超级红包转链)

调用权限:核心接口会员卡调用
接口使用场景等说明:

本接口用于直接获取京东的产品、店铺、大促活动、超级红包等转链。

API支持多种产品参数,比如产品ID、产品详情页(推广物料url)、别人的推广长链接和短链接等形式,同时接口自动检查优惠券,不需要您去查券,不需要再传入券链接,除非您有其它的券。


接口支持的转链类型包括:

1、产品转链。

2、店铺转链。

3、超级红包转链。

4、大促会场转链。

5、营销频道转链等等。


【新人参考】京东联盟接口参数unionId、key、推广位positionId(PID)、网站站点ID(或APP ID)在哪找到?


附:如需跳转小程序信息:

京东购物小程序ID: wx91d27dbf599dff74

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

接口请求地址

环境 http 地址 https 地址
正式环境 http://api.veapi.cn/jd/jd_prombyuid 暂无

请求方式:GETPOST

请求参数

参数名称 参数类型 必填 示例值 描述
vekey String V123M56 公共参数,接口秘钥,请在会员中心获取
materialId String https://u.jd.com/tiVIBcR 推广物料,支持多种形式,包括商品ID、活动链接、商品链接、店铺链接、联盟链接、大促会场、超级红包等,包含微信shortlink形式;当您提供数字商品ID入参转链时,需要您具有场景ID2权限并在会员中心使用京东联盟帐号授权后,才能使用。
unionId Number 1001034551 您的京东联盟ID。如果不了解,可以参考这里
positionId Number 6 新增推广位id,纯数字(不填的话,为其默认生成一个唯一此接口推广位-名称:微信手Q短链接),跟单可用此参数(查看跟单说明),每个京东联盟的帐号positionId数量限制5000个。
detail Number 默认0 是否需要更详细信息,传入可选值1,获取产品更多信息。
sceneId Number 1 场景ID,支持入参1,2;2需要权限申请
pid String 618_618_6018 联盟子推客身份标识(不能传入接口调用者自己的pid)
autocoupon Number 默认1 如果有券时,是否直接把优惠券合并到推广链接上,可选值1或0,默认1用户先跳到领券页。指定0时推广链接直接跳到产品页,不领券。
couponUrl String http://coupon.jd..... 优惠券领取链接,如果您有指定券,可传入本参数。在使用优惠券、商品二合一功能URL入参时,materialId须为商品详情页链接。本参数需要urlencode编码
subUnionId String 618_18_ce6a 子渠道标识,仅支持传入字母、数字、下划线或中划线,最多80个字符(不可包含空格),该参数会在订单行查询接口中展示(需申请权限,subUnionId申请需要日UV10000以上,订单在1000单/月,GMV在10000以上/月)
chainType Number 1 转链类型,1:长链, 2 :短链 ,3: 长链+短链,默认短链,短链有效期60天
giftCouponKey String xxx_coupon_key 礼金批次号
channelId Number 12345 渠道关系ID
command Number 1 是否生成短口令:1生成,默认不生成
weChatType Number 1 微信小程序ShortLink类型(需申请权限)
rid String 435676 团长的子渠道id,由团长自定义分配。取rid的优先级:入参rid优先materialId中拼接的rid,materialId中拼接的rid优先cps链接后面拼接的rid。
proType Number 5 5:种草版二合一

请求示例

  • HTTP
  • PHP
  • JAVA
  • PYTHON
GET/POST  http://api.veapi.cn/jd/jd_prombyuid?detail=1&chainType=3&materialId=10044869415448&unionId=1001034551&positionId=1818437423&vekey=xxx 
【例子】使用详情页参数
http://api.veapi.cn/jd/jd_prombyuid?detail=1&chainType=3&materialId=https://item.jd.com/10044869415448.html&unionId=1001034551&positionId=1818437423&vekey=xxx
【例子】使用推广链接参数
http://api.veapi.cn/jd/jd_prombyuid?detail=1&chainType=3&materialId=https://u.jd.com/mIKZpB2&unionId=1001034551&positionId=1818437423&vekey=xxx
使用curl函数,curl不是php原生库,需要安装才能使用

$api="http://api.veapi.cn/jd/jd_prombyuid?detail=1&chainType=3&materialId=10044869415448&unionId=1001034551&positionId=1818437423&vekey=xxx";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $api);
//curl_setopt($ch, CURLOPT_POST, true);  //POST方式时启用
//curl_setopt($ch, CURLOPT_POSTFIELDS, $postData );  //POST方式时传参

curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);  //如果使用https请启用
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);  //如果使用https请启用
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true );   //返回数据流,不直接输出
curl_setopt($ch, CURLOPT_ENCODING, 'gzip'); //使用gzip压缩传输让访问更快
curl_setopt($ch, CURLOPT_TIMEOUT, 6);  //允许执行的最长秒数。这里设定6S
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5);

$result = curl_exec($ch);
$info = curl_getinfo($ch);
curl_close($ch);

echo $result; //返回值
使用okhttp3/httpclient/jsoup/hutool,以hutool为例:

import cn.hutool.http.HttpResponse;
import cn.hutool.http.HttpRequest;

public class testGetParam {

    public static void main(String[] args) {
        // API网址
        String url = "http://api.veapi.cn/jd/jd_prombyuid?detail=1&chainType=3&materialId=10044869415448&unionId=1001034551&positionId=1818437423&vekey=xxx";
        // JDK 8u111版本后,若目标页面为HTTPS协议,请启用proxy用户密码鉴权
        //System.setProperty("jdk.http.auth.tunneling.disabledSchemes", "");

        // 发送请求
        String result = HttpRequest.get(url)
                .timeout(10000)//设置超时,毫秒
                .execute().body();
        System.out.println(result);
    }
}
推荐使用 requests,支持访问http,https网页:

import requests
		
# 要访问的API网页
target_url = "http://api.veapi.cn/jd/jd_prombyuid?detail=1&chainType=3&materialId=10044869415448&unionId=1001034551&positionId=1818437423&vekey=xxx"

# 发送请求
response = requests.get(target_url)

# 获取页面内容
if response.status_code == 200:
	print response.text

返回值(JSON)

参数名称 参数类型 是否必选 示例值 描述
trans_type Number 1 表示这次转链处理的参数类型:1-商品类,2-店铺类,3-活动会场或超红或礼金类,0-无法判断
shortURL String https://union-click.jd.com/jdc?d=XXXXXX 生成的推广目标链接,以短链接形式,有效期60天,如需跳转京东购物小程序,请按上文介绍跳转。
clickURL String https://union-click.jd.com/jdc?e=XXXX 生成推广目标的长链,长期有效
jCommand String 6.0复制整段话http://JhT7V5wlKygHDK京口令内容#J6UFE5iMn*** 需要权限申请,京口令(匹配到红包活动有效配置才会返回京口令)
jShortCommand String 短口令 需要权限申请,短口令
weChatShortLink String #小程序://京小街/**** 微信小程序ShortLink(需申请权限)
商品detail字段 Map[]   当有detail参数且为产品时才有字段。详情字段请参考,当转链的是店铺推广链接或活动链接,或会场链接时,没有返回详情字段。

返回示例

【提示】推广链接通常有时效性,示例中的链接为创建文档时生成,仅用于展示返回结果使用,有可能已失效。
{ "error": "0", "msg": "查询成功!", "trans_type": 1, "data": { "clickURL": "https://union-click.jd.com/jdc?e=1001033619&p=JF8BAYQJK1olXg4CVF9YDEkRAF8IGloQWA8FXFtdDE4SCl9MRANLAjZbERscSkAJHTRQRA1CCVkdDwtCWhVLHTdNTwcKBENeCVAfUg8bA24JHl4cWg4HVFpYDUIAQ2N8YitwKXV1CClfUiJgYBxIbDJDBWJhMBg9UBZhYW5oXS1wLWBlDS4UfCkWZw1BcxtjL1twNhclTjxuUQ98UhJCK39mMCouaxdjahdQfwFlG2VgMz0JCzdpczdsfSwUNkJ2PSEvaxIXQRtxeChhBAZeNAEHbit0fCx_YiRiKQd2XD4kfClsYCZJbwRlP3JxAR0qUj8DARo4QiRgK2FDIwc-dx9nYSZ1QEVTOG5SNFJROEonA24JG1oXWAIGVG5tCEsnQgEIG1MdWwUEVG5dAUseBm0OHlgXbQYFUl5bCE0XB2wIHFglXQ4FZF1cCEtBWCw4K2sWbQYDVV5cCkkQA2c4K1sWbQUyCjBcW05ABG0PSDVIDk0GXVYWDyUTA20NGFgdXTYAVV9fCnsn", "shortURL": "https://u.jd.com/mIKZpB2", "brandCode": "464314", "brandName": "泊泉雅(BIOAQUA)", "categoryInfo": { "cid1": "16750", "cid1Name": "个人护理", "cid2": "16753", "cid2Name": "身体护理", "cid3": "16795", "cid3Name": "其它身体护理" }, "comments": "900", "commissionInfo": { "commission": "5.98", "commissionShare": "20.0", "couponCommission": "1.98", "endTime": "2147529599000", "isLock": "0", "plusCommissionShare": "20.0", "startTime": "1662566400000" }, "couponInfo": { "couponList": [ { "bindType": "3", "discount": "19.0", "getEndTime": "1672243198000", "getStartTime": "1671419061000", "isBest": "0", "isInputCoupon": "0", "link": "https://coupon.m.jd.com/coupons/show.action?linkKey=AAROH_xIpeffAs_-naABEFoetAOPeZb_U6UkGIjCKLYvU2C-_nURnNLPVmvDRxjJ3YrT69OzimcVQtjsa3ggH0QBVI6Slw", "platformType": "0", "quota": "29.0", "useEndTime": "1672243199000", "useStartTime": "1671379200000" }, { "bindType": "3", "discount": "20.0", "getEndTime": "1675180798000", "getStartTime": "1667664060000", "isBest": "1", "isInputCoupon": "0", "link": "https://coupon.m.jd.com/coupons/show.action?key=gbu7ifd9e5250c29513b9ca6081f1a25&roleId=91567896&to=", "platformType": "1", "quota": "21.0", "useEndTime": "1675180799000", "useStartTime": "1667664000000" } ] }, "deliveryType": "0", "eliteType": [ 1 ], "forbidTypes": [ 0 ], "goodCommentsShare": "99.0", "imageInfo": { "imageList": [ { "url": "https://img14.360buyimg.com/pop/jfs/t1/190469/26/22966/312599/625558c4Ecf8bc3f4/f538f6492b340d5f.jpg" }, { "url": "https://img14.360buyimg.com/pop/jfs/t1/136545/13/31213/45753/636f83c9Efd8f57d0/4e98deea02fcaefd.jpg" }, { "url": "https://img14.360buyimg.com/pop/jfs/t1/104802/38/24162/957727/6214793dE76b57599/79fd541b28551376.jpg" }, { "url": "https://img14.360buyimg.com/pop/jfs/t1/84794/26/21072/83819/6214793dE2e3cb6f7/e1a40f3bbf857f94.jpg" }, { "url": "https://img14.360buyimg.com/pop/jfs/t1/220087/10/12889/138602/6214793dEfc563bd8/68fca79a8bc33b5d.jpg" }, { "url": "https://img14.360buyimg.com/pop/jfs/t1/210794/11/17851/96534/6214793dE1d4d1a95/e86ca46ae8c0b521.jpg" }, { "url": "https://img14.360buyimg.com/pop/jfs/t1/108615/12/23471/442654/6214793eE1509f3c4/5de7b8965d8375cf.jpg" }, { "url": "https://img14.360buyimg.com/pop/jfs/t1/173208/32/28459/425443/6214799eEc573c315/9c805a7bf60f2377.jpg" }, { "url": "https://img14.360buyimg.com/pop/jfs/t1/159452/27/28810/122691/62149b1aE099e9ba4/591b357897d7e4c5.jpg" } ], "whiteImage": "https://img14.360buyimg.com/pop/jfs/t1/209160/12/18050/204353/62149b20E3cb24f25/2a2d47868624b73e.png" }, "inOrderComm30Days": "101.52", "inOrderCount30Days": "100", "isHot": "1", "isJdSale": "0", "materialUrl": "item.jd.com/10044869415448.html", "owner": "p", "pinGouInfo": {}, "pingGouInfo": {}, "priceInfo": { "lowestCouponPrice": "9.9", "lowestPrice": "29.9", "lowestPriceType": "1", "price": "29.9" }, "shopInfo": { "afsFactorScoreRankGrade": "中", "afterServiceScore": "8.90", "commentFactorScoreRankGrade": "高", "logisticsFactorScoreRankGrade": "低", "logisticsLvyueScore": "8.10", "scoreRankRate": "50.04", "shopId": "11737989", "shopLabel": "0", "shopLevel": "4.0", "shopName": "尧先个护专营店", "userEvaluateScore": "9.19" }, "skuId": "10044869415448", "skuName": "【精选好物】润唇膏女保湿滋润嘴唇防冻干裂脱皮无色不油腻补水学生男女士通用 润唇膏x3支", "spuid": "10022099012962", "videoInfo": [] }, "request_id": "lanNgG2" }

错误码

如果error不为0时,请点此查看错误码表格

相关文章:

在线
客服

会员请加QQ群交流:

微信
咨询

加微信咨询
顶部