接口使用场景等说明:本接口支持淘客、拼多多(多多进宝)、京东联盟、唯品会、抖客精选联盟全平台转链,返回通用和主要的字段。
适用于微信查券等场景。
当您不知道用户输入了什么内容时,可使用本接口。
【特别注意】
1、当生成的是淘宝联盟的内容时,接口可以处理商品、店铺、活动ID等各类型。
请注意parse_type参数,有可能是商品,也有可能店铺推广转链,也有可能是会场转链。这时字段会有不同,请注意判断
2、2024年2月起,请传入version=202402参数,切换到新版
环境 | http 地址 | https 地址 |
---|---|---|
正式环境 | http://api.veapi.cn/global/unionhc | 暂无 |
参数名称 | 参数类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
vekey | String | 是 | V123M56 | 公共参数,接口秘钥,请在会员中心获取 |
version | String | 否 | 202402 | 版本号。2024年2月起,请传入version=202402参数,切换到新版 |
para | String | 是 | 1 | 商品ID或淘口令或淘宝京东拼多多等平台链接 |
pid | String | 是 | mm_111111_222222_333333 | 淘宝联盟的推广位PID |
positionId | String | 否 | 123456789 | 京东的positionId,用于京东的跟单 |
vip_pid | String | 否 | 123456 | 唯品会的推广位或chanTag参数。 |
pdd_pid | String | 是 | 123456_7890123 | 多多进宝的推广位(可搭配PID关联的custom_parameters参数) |
dk_pid | String | 是 | 123456 | 抖客精选联盟的PID。 |
custom_parameters | String | 是 | 123456_7890123 | 与多多进宝PID关联的custom_parameters参数 |
sessionkey | String | 是 | 700113223...55651 | 淘宝联盟授权码,如在会员中心授权过可不传 |
pdd_sessionkey | String | 是 | 7D4511fdDF2...DF | 拼多多的授权码,如在会员中心授权过可不传 |
vip_sessionkey | String | 是 | 95122DFDSf...2d | 唯品会的授权码,如在会员中心授权过可不传 |
jd_sessionkey | String | 是 | 95122DFDSf...2d | 京东的key,到京东联盟后台领取 |
dk_sessionkey | String | 是 | dfae...1F | 抖客的授权码。 |
unionId | String | 是 | 5661212512 | 京东的联盟帐号ID。 |
account_id | String | 否 | 联盟号id | 会员中心有多个授权时,用本参数指定要查询哪一个联盟号id,联盟号ID请到会员中心授权页查看 |
其它转链参数 | String | 否 | 如:relationId=12232 | 参考各平台转链接口的其它参数,如渠道ID |
GET/POST http://api.veapi.cn/global/unionhc?vekey=xxx¶=pnBJmGnuxt67O86h59Ahptm-wnQObgUQbdKMgWKsdW&unionId=1001034551&positionId=&pid=&vip_pid=&pdd_pid=4079456_34211517&custom_parameters=6688
$api="http://api.veapi.cn/global/unionhc?vekey=xxx¶=pnBJmGnuxt67O86h59Ahptm-wnQObgUQbdKMgWKsdW&unionId=1001034551&positionId=&pid=&vip_pid=&pdd_pid=4079456_34211517&custom_parameters=6688"; $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/global/unionhc?vekey=xxx¶=pnBJmGnuxt67O86h59Ahptm-wnQObgUQbdKMgWKsdW&unionId=1001034551&positionId=&pid=&vip_pid=&pdd_pid=4079456_34211517&custom_parameters=6688"; // 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/global/unionhc?vekey=xxx¶=pnBJmGnuxt67O86h59Ahptm-wnQObgUQbdKMgWKsdW&unionId=1001034551&positionId=&pid=&vip_pid=&pdd_pid=4079456_34211517&custom_parameters=6688" # 发送请求 response = requests.get(target_url) # 获取页面内容 if response.status_code == 200: print response.text
参数名称 | 参数类型 | 示例值 | 描述 |
---|---|---|---|
plat_type | String | 1 | 平台类型:1-淘宝联盟,2-拼多多,3-京东,4-唯品会,5-抖客 |
plat_name | String | 淘宝联盟 | 平台名称:对plat_type描述 |
parse_type | Number | 1 | 转链类型:1—单品 2—店铺 3—会场 4-承接开放 5-优惠券 |
material_name | String | 店铺转链 | 返回类型描述:对parse_type描述 |
title | String | 维他奶真豆醇麦豆奶营养早餐植物奶 | 产品标题 |
shop_name | String | 天猫超市 | 店铺名称 |
item_id | String | 56612223310 | 产品ID |
reserve_price | String | 87.2 | 原价,如果是拼多多,则是单买价。 |
price | String | 67.2 | 折后价,还没减去优惠券前的价格。如果是拼多多,则是拼团价。 |
final_price | String | 57.2 | 到手价,令当淘宝联盟时才有这个字段。表示折后价price再减掉优惠券、跨店满减等各种优惠后的到手价。 |
main_pic | String | https://img....jpg | 产品主图 |
white_image | String | https://img....jpg | 白底图,该字段不一定有值,取决于商品是否有白底图 |
commission_rate | String | 1.3 | 佣金,百分比值 |
prom_url | String | http://m.tb.cn/h.dxsdf | 您的推广链接 |
coupon_info | Object | 有券时才返回 | 优惠券信息,无券时为空 |
└─ coupon_start_time | String | 2023-03-11 00:00:00 | 优惠券启用时间 |
└─ coupon_end_time | String | 2023-03-31 23:59:59 | 优惠券结束时间 |
└─ coupon_remain_count | String | 6000 | 优惠券剩余量,当为京东时-1表示不限 |
└─ coupon_total_count | String | 10000 | 优惠券总量,当为京东时-1表示不限 |
└─ coupon_info | String | 满78元减10元 | 优惠券描述 |
└─ coupon_amount | String | 10 | 优惠券面额,如“满78元减10元”中的10元。 |
└─ coupon_start_fee | String | 78 | 优惠券起用金额,如“满78元减10元”中的78元。 |
tkl | Object | 淘口令字段内容。 | |
└─ has_tkl | Number | 1 | 是否有淘口令或抖口令,0无,1有 |
└─ dk_pwd | String | 3:/ 长按商品ÑÑtCEcsEgbuhq8G8ㄍ | 抖口令,仅当为抖客商品时才有此字段。 |
└─ tbk_pwd | String | ¥2qHbdRkI0nl¥ | 普通淘口令,仅当商品为淘宝联盟商品时才有此字段。不适合在IOS使用 |
└─ ios_tbk_pwd | String | 17¥ CZ3457 2qHbdRkI0nl¥ https://m.tb.cn/h.UqZ8RNs 新豪 | IOS系统用淘口令,较长。安卓也可用。仅当商品为淘宝联盟商品时才有此字段。 |
└─ global_tbk_pwd | String | 8¥ CZ3457 2qHbdRkI0nl¥/ | 通用淘口令,IOS和安卓均通用,仅当商品为淘宝联盟商品时才有此字段。 |
shop_type | String | 1 | 店铺类型, 取决于返回值plat_type输出的平台类型而值含义有不同: (1)当为淘宝联盟时值0表示淘宝,1天猫。 (2)当为京东产品时,值g表示自营,p表示POP。 (3)当为拼多多时,值1表示个人,2-企业,3-旗舰店,4-专卖店,5-专营店,6-普通店。 (4)当为唯品会时,值0表示自营,1表示MP |
cps_long_url | String | https://s.click.taobao.com/t?e=m2.. | 【当parse_type不为1商品时才有该字段】商品、店铺或活动会场的CPS链接长链 |
cps_short_tpwd | String | ¥zRmVdesjTCu¥ | 【当parse_type不为1商品时才有该字段】CPS链接的短口令 |
cps_short_url | String | https://s.click.taobao.com/CvHjOPu | 【当parse_type不为1商品时才有该字段】CPS链接短链 |
cps_full_tpwd | String | 39¥ CZ3457 zRmVdesjTCu¥ https://m.tb.cn/h.UQ4cewa 粉条六袋装 | 【当parse_type不为1商品时才有该字段】CPS链接的长口令 |
seller_id | String | 123456 | 【当parse_type不为1商品时才有该字段】卖家ID |
page_id | String | 20150318020014311 | 【当parse_type不为1商品时才有该字段】会场ID |
{ "error": "0", "msg": "全平台转链成功,本次结果为淘宝客转链!", "plat_type": 1, "plat_name": "淘宝联盟", "data": { "title": "OP3N开心牛奶公司翻来翻去多口味酸奶*12杯 翻趣杯风味酸牛奶低温", "shop_name": "OP3N食品旗舰店", "item_id": "G0G3BpaT8tXkMavsvkWCgUJ-M8gNorsV3xDVnxdiRw", "reserve_price": "156.00", "price": "78.00", "main_pic": "https://img.alicdn.com/bao/uploaded/i1/2213069545909/O1CN01kZlKeN1tWNAkS43Lo_!!0-item_pic.jpg", "white_image": "https://img.alicdn.com/bao/uploaded/O1CN01ulg23f1Fz9QPh8OJi_!!6000000000557-0-yinhe.jpg", "commission_rate": "4.50", "prom_url": "https://s.click.taobao.com/FpBOgKu", "coupon_info": { "coupon_start_time": "2023-03-11 00:00:00", "coupon_end_time": "2023-03-31 23:59:59", "coupon_remain_count": "49440", "coupon_total_count": "50000", "coupon_info": "满78元减10元", "coupon_amount": "10", "coupon_start_fee": "78" }, "tkl": { "has_tkl": 1, "tbk_pwd": "¥P0GLdj0cB9p¥", "ios_tbk_pwd": "79¥ CZ3457 P0GLdj0cB9p¥ https://m.tb.cn/h.UKxiNtL OP3N开心牛奶公司翻来翻去多口味酸奶*12杯 翻趣杯风味酸牛奶低温", "global_tbk_pwd": "3¥ CZ3457 P0GLdj0cB9p¥/" }, "shop_type": "1", "hascoupon": 1 }, "request_id": "XyP3yCZ" }