API文档中心

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

全网转链接口(支持淘客、拼多多、京东、唯品会、抖客)

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

本接口支持淘客、拼多多(多多进宝)、京东联盟、唯品会、抖客精选联盟全平台转链,返回通用和主要的字段。


适用于微信查券等场景。

当您不知道用户输入了什么内容时,可使用本接口。


【特别注意】

1、当生成的是淘宝联盟的内容时,接口可以处理商品、店铺、活动ID等各类型。

请注意parse_type参数,有可能是商品,也有可能店铺推广转链,也有可能是会场转链。这时字段会有不同,请注意判断


2、2024年2月起,请传入version=202402参数,切换到新版

调用说明

本接口需要您在会员中心授权(如果多用户可传入sessionkey参数)

接口请求地址

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

请求方式:GETPOST

请求参数

参数名称 参数类型 必填 示例值 描述
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

请求示例

  • HTTP
  • PHP
  • JAVA
  • PYTHON
GET/POST  http://api.veapi.cn/global/unionhc?vekey=xxx&para=pnBJmGnuxt67O86h59Ahptm-wnQObgUQbdKMgWKsdW&unionId=1001034551&positionId=&pid=&vip_pid=&pdd_pid=4079456_34211517&custom_parameters=6688 

使用curl函数,curl不是php原生库,需要安装才能使用

$api="http://api.veapi.cn/global/unionhc?vekey=xxx&para=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; //返回值
使用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/global/unionhc?vekey=xxx&para=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);
    }
}
推荐使用 requests,支持访问http,https网页:

import requests
		
# 要访问的API网页
target_url = "http://api.veapi.cn/global/unionhc?vekey=xxx&para=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

返回值(JSON)

参数名称 参数类型 示例值 描述
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" }

错误码

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

在线
客服

会员请加QQ群交流:

微信
咨询

加微信咨询
顶部