接口使用场景等说明:本接口用于直接获取京东的产品、店铺、大促活动、超级红包等转链。
API支持多种产品参数,比如产品ID、产品详情页(推广物料url)、别人的推广长链接和短链接等形式,同时接口自动检查优惠券,不需要您去查券,不需要再传入券链接,除非您有其它的券。
接口支持的转链类型包括:
1、产品转链。
2、店铺转链。
3、超级红包转链。
4、大促会场转链。
5、营销频道转链等等。
【新人参考】京东联盟接口参数unionId、key、推广位positionId(PID)、网站站点ID(或APP ID)在哪找到?
【如何跟单】
新人跟单请使用positionId参数,当您达到“日UV10000以上,订单在1000单/月,GMV在10000以上/月”时,可向官方申请subUnionId参数跟单。
如何跳到京东小程序?
(1)在您的小程序上跳转到京东小程序所需信息:
京东购物小程序ID(appId): wx91d27dbf599dff74
跳转路径:pages/union/proxy/proxy?spreadUrl=跳转短连接
(2)从微信聊天界面跳到京东小程序:
需要您向cps-qxsq@jd.com申请接口的weChatType字段权限,调用本接口后得到weChatShortLink值,如“#小程序://京小街/****”即可跳到京东小程序。
| 环境 | http 地址 | https 地址 |
|---|---|---|
| 正式环境 | http://api.veapi.cn/jd/jd_prombyuid | 暂无 |
| 参数名称 | 参数类型 | 必填 | 示例值 | 描述 |
|---|---|---|---|---|
| vekey | String | 是 | V123M56 | 公共参数,接口秘钥,请在会员中心获取 |
| materialId | String | 是 | https://u.jd.com/tiVIBcR | 推广物料,支持多种形式,包括商品ID、活动链接、商品链接、店铺链接、联盟链接、大促会场、超级红包等,包含微信shortlink形式;当您提供数字商品ID入参转链时,需要您具有场景ID2权限并在会员中心使用京东联盟帐号授权后,才能使用。 |
| unionId | Number | 是 | 1001034551 | 您的京东联盟ID。如果不了解,可以参考这里,【很重要】unionId一定要传对,否则你的订单会丢失。 |
| positionId | Number | 否 | 6 | 新增推广位id,纯数字(不填的话,为其默认生成一个唯一此接口推广位-名称:微信手Q短链接),跟单可用此参数(查看跟单说明),每个京东联盟的帐号positionId数量限制5000个。 |
| detail | Number | 否 | 默认0 | 是否需要更详细信息,传入可选值1,获取产品更多信息。 |
| sceneId | Number | 否 | 1 | 场景ID,支持入参1,2;2需要权限申请 |
| pid | String | 否 | 618_618_6018 | 联盟子推客身份标识(不能传入接口调用者自己的pid) |
| couponUrl | String | 否 | http://coupon.jd..... | 优惠券领取链接,如果您有指定券,可传入本参数。在使用优惠券、商品二合一功能URL入参时,materialId须为商品详情页链接。本参数需要urlencode编码 |
| autocoupon | Number | 否 | 默认1 | 如果有券时,是否直接把优惠券合并到推广链接上,可选值1或0,默认1用户先跳到领券页。指定0时推广链接直接跳到产品页,不领券。注意本参数对有指定couponUrl券时无效。 |
| subUnionId | String | 否 | 618_18_ce6a | 子渠道标识,仅支持传入字母、数字、下划线或中划线,最多80个字符(不可包含空格),该参数会在订单行查询接口中展示(需向cps-qxsq@jd.com申请权限,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:种草版二合一 |
| usenumid | Number | 否 | 1 | 可选1或0,当您需要解析京东数字ID并且购买了“数字ID转字符”专用点卡后,可添加此参数。使用本参数需要具备:1、购买了专用点卡后才有效;2、不需要再传入sceneId参数,3、本参数对于未参加联盟CPS推广的商品是无效的。 |
| sessionkey | String | 否 | 7002 | 多用户专用。如果您的会员卡是多用户版订单查询接口,若要查不同的帐号,请提供该帐号授权的sessionkey值 |
| account_id | String | 否 | 联盟号id | 会员中心有多个授权时,用本参数指定要查询哪一个联盟号id数据,联盟号ID请到会员中心授权页查看 |
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
$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; //返回值
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);
}
}
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
| 参数名称 | 参数类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| 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(需向cps-qxsq@jd.com申请权限) |
| 商品detail字段 | Map[] | 否 | 当有detail参数且为产品时才有字段。详情字段请参考,当转链的是店铺推广链接或活动链接,或会场链接时,没有返回详情字段。 |