API文档中心

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

淘客产品和官方活动万能转链-升级版

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

本接口近期下线,请尽快切换到新版万能转链接口 https://www.veapi.cn/apidoc/taobaolianmeng/366 


本接口是产品万能转链升级版,是整合“产品和淘宝各类活动”解析和转链功能的接口,目的是让有些场景更方便一个接口处理用户所有查询和转换类型。

API保持了原淘客产品万能转链轻松处理各类参数的特色,增加了活动解析和转链功能。这里的“活动”,是指淘宝618,双11,年会等大促时各种会场,和超级红包的活动,在淘宝联盟官网会员中心——活动中心,可以看到官方的活动列表。

除了正常传入活动ID以外,也可以使用别人活动淘口令、链接。从而转换成您的活动推广链接(部分活动链接无法解析)。

因此,这个接口等于“产品万能转链+官方活动解析转链”两个接口的整合版。大大简化了调用。


1、原有产品万能转链如何无缝切换到升级版?

原有hcapi万能转链接口,所有入参不用更换就可以。只要做好返回值trans_type判断即可:

(1)当trans_type=1时,原有hcapi接口可以不用更改,完全一样。

(2)当trans_type=2时,表法返回值是官方活动,做对应处理即可。参考活动转链接口升级版


2、相关的两个接口地址:

(1)产品万能转链:http://www.veapi.cn/apidoc/taobaolianmeng/80 

(2)官方活动转链:http://www.veapi.cn/apidoc/taobaolianmeng/134 


3、特别提示:

(1)根据联盟新规,请尽量使用新字符串ID或淘口令或推广链接入参。数字ID入参仅限手淘APP比价场景可使用。

(2)接口将关闭所有B段+场景3入参,不再接收外部B段入参。


【新版公告】

新版万能转链接口上线,欢迎使用,比现有的增加了活动、店铺转链处理功能。有需要可切换 https://www.veapi.cn/apidoc/taobaolianmeng/366 

但新版万能转链接口暂时没有自动保持入参中优惠券ID,也不支持自定义券ID(后续会增加)。请按需选择。


目前还在使用sid跟单的,请暂时保持现版hcapi转链接口。

调用说明

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

接口请求地址

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

请求方式:GETPOST

请求参数

参数名称 参数类型 必填 示例值 描述
vekey String V123M56 公共参数,接口秘钥,请在会员中心获取
para String ¥TA1WdUtzfbP¥ 各类产品类参数或官方活动参数:如手淘分享的整段文案或产品ID或链接等十多种参数,参考指引说明,请务必urlencode编码后传参。比如:
1.淘宝产品ID
2.官方活动ID
3.产品或活动淘口令
4.活动或产品链接
detail Number 默认0 可选值1或2,表示需要更多产品信息的字段。设置为1时,表示获取常规信息;设置为2时,表示要获取到手价、促销信息、百亿补贴等更完整信息,当您指定为2时,相关字段含义参考搜索接口升级版
pid String mm_11_22_33 淘客推广位,如在会员中心有设置PID可不传参,否则必须传参。
account_id String 联盟帐号ID 联盟帐号ID值,当一个维易号会员中心有2个以上联盟授权时,本参数指定要转链的联盟号,这时pid参数要和联盟号一致。请到会员中心授权页查看联盟号ID值
relationId Number 565412325 渠道关系ID值,务必配合使用“渠道专属PID”,不能使用普通PID。
special_id Number 688441233 会员运营ID,当你传了本参数时,请务必使用“会员专属PID”,这样下单时才有透出会员运营ID。
external_id Number 21231 淘宝客外部用户标记,需配合渠道接口(publisherget)获取special_id,此参数详细用法和比价说明点此了解
activityId Number dfdfDFsdf56522232adfDA 指定优惠券id,提供本参数后接口自动在返回的推广链接后面添加该券id及该券信息。本参数和deepcoupon参数只能使用一个,如果一起使用,则deepcoupon参数失效。
deepcoupon Number 默认0 可选值1或2,参数值含义:1-表示对联盟产品无官方优惠券时,则进行检查是否有商家合作券;2-(不建议)表示不管转链的商品有没有券,都进行进一步检查商家合作券,如果商品本身就有单品券,则与检查出来的商家合作券取“券面额大”的一个使用。使用shopcoupon和deepcoupon参数,调用接口会有一定的效率损失。
shopcoupon Number 默认0 可选值1,当指定1时,接口会整合你传递的淘口令或淘客链接的参数中店铺券返回。如果你发现原淘口令中有店铺券,但接口返回没有店铺券,可以加上本参数,则返回值会保持原口令中的店铺券。本参数可以和deepcoupon一起使用。
notkl Number 默认0 可选值1,接口默认会返回淘口令(tbk_pwd 字段),当您不需要返回值中包含淘口令时,请添加此参数notkl=1取消接口中返回淘口令,这样接口调用效率更高。
noshortlink Number 默认0 可选值1,接口默认会返回短链接(coupon_short_url 字段),如果您不需要此字段,使用本参数取消接口返回短链,并自行按需对返回值中的长链接生成短链,推荐使用本参数,这样可以提高您的高佣接口调用效率。
couponId Number 默认0 是否需要优惠券ID值返回,可选值0或1,如果传了本参数couponId=1则返回优惠券ID(在有券的情况下)。返回值中多了一个字段coupon_id。如果商品无券则coupon_id为空。仅当detail参数为1时,本参数有效。
xid Number 1232323 招商团长专用:团长与下游渠道合作的特殊标识,用于统计渠道推广效果
bybt Number 默认0 (已废弃)可选1,如有淘宝百亿补贴将显示百亿补贴后的价格。目前遇到百亿补贴商品转链时自动处理,不需要再传本参数。
plhc String 默认0 可选值1 启用高佣批量转链,当启用本参数时,参数para必须是商品ID列表,如para=23883488910,598450446711...
get_topn_rate Number 默认0 可选值0或1,618大促等字段专用,表示是否获取前N件佣金 ,0-否,1-是
ucrowd_id Number 默认0 会员人群ID,用于统计人群推广效果
mini_program_link Number 默认0 可选1,是否需要获取小程序链接(暂未对外开放)
promotion_type Number 默认0 请按新字符串ID政策正确传参。可选值 1-自购省,2-推广赚(代理模式专属ID,代理模式是,非代理模式不用填写该字段)
biz_scene_id Number 可不传或空 【已废弃,请勿用】场景参数
weibo Number 默认0 可选1或传您自己的域名,使用本参数,将生成微博跳到手淘的防拦截链接,指定值1时,将使用本站提供的域名,如果您自己有域名,可以指定域名,比如 weibo=www.veapi.cn 或weibo=https://www.veapi.cn (不传https时默认为http),您提供的域名必须解析到指定IP,IP地址请联系客服。
tkl_type Number 默认0 可选值1和0,默认0,指定1时表示使用无券推广链接sclick_url生成短链接和淘口令,这样购买时跳过二合一领券页。
sessionkey String 7002455622... 淘客授权字串,本参数仅限多用户版,当您的接口卡是多用户版时,请提供本参数和对应联盟号的Pid参数

请求示例

  • HTTP
  • PHP
  • JAVA
  • PYTHON
GET/POST  http://api.veapi.cn/tbk/hcapi_v2?vekey=xxx&para=https://m.tb.cn/h.UPnQWRp&detail=1 
【例子】直接转链全段手淘分享文本
http://api.veapi.cn/tbk/hcapi_v2?vekey=xxx&para=97¥ CZ0001 SOS7defeKjf¥ https://m.tb.cn/h.URqhfIE 短袖t恤女白色纯棉(实际使用请对para参数url编码)
【例子】转官方活动ID
http://api.veapi.cn/tbk/hcapi_v2?vekey=xxx&para=20150318020014562
【例子】转官方活动链接或口令
http://api.veapi.cn/tbk/hcapi_v2?vekey=xxx&para=37¥ CZ0001 5ogHd5Xj2wq¥ https://m.tb.cn/h.UPnQWRp U选快抢
使用curl函数,curl不是php原生库,需要安装才能使用

$api="http://api.veapi.cn/tbk/hcapi_v2?vekey=xxx&para=https://m.tb.cn/h.UPnQWRp&detail=1";

$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/tbk/hcapi_v2?vekey=xxx&para=https://m.tb.cn/h.UPnQWRp&detail=1";
        // 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/tbk/hcapi_v2?vekey=xxx&para=https://m.tb.cn/h.UPnQWRp&detail=1"

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

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

返回值(JSON)

参数名称 参数类型 示例值 描述
trans_type Number 1 转链类型:0-表示转链失败,1-指本次转链是产品,2-指本次转链是活动。决定了data字段不同。
产品详情字段 Map 1 仅当trans_type=1时才有产品详情字段,产品详情各字段含义参考这里
活动字段 Map 1 仅当trans_type=2时才有活动字段,活动各字段含义参考这里

返回示例

【提示】推广链接通常有时效性,示例中的链接为创建文档时生成,仅用于展示返回结果使用,有可能已失效。
{ "error": "0", "msg": "官方活动信息获取成功!", "trans_type": 2, "data": { "click_url": "https://s.click.taobao.com/t?union_lens=lensId%3AMAPI%401673618202%40213373a9_0c35_185ab6b1fbf_c372%4001%40eyJmbG9vcklkIjozMTg0N30ie%3BeventPageId%3A20150318020014562&e=m%3D2%26s%3Dgc0YmE4Gh%2BVw4vFB6t2Z2iperVdZeJviU%2F9%2F0taeK29yINtkUhsv0BCmvYKkqFYzxY5AGh%2FmSsUL60FsZM9I2TIgTwpFUxJ%2BJzdJ3rdo4hcyJwaoKcyDsvAy%2Fay3dFHhcfoqCASFBE0Sylq0DylJrqED5kW4yHt0jidl2Va2D8n8vUvLpOt0bJMibMpkWOTSnsuZCKOWWOszuTGl041QArZl6wCRgzZSsd%2B%2Ff4Fhw9b%2BScqIfI2efLAHkyFZtBih5NH%2BHenq8WP6TpwQjilrdBoR3336zCy65Vp%2B1lQZII6fF2mNtOHXW%2B%2F9SMD5NOKOvsDZTzR3ZwHMf9XDrUin6ogPh2VpbvcT8PwOkD4ulZfxvNaaibhIncDlE6H93yEw17wnkme1OdGDcT9IgYeWF%2FeiVvaEiF03Z3NEK3xpqJZ8C2OCXuuDpm6aDGlpyAWA", "material_oss_url": "https://creative-material-public.oss-cn-shanghai.aliyuncs.com/a/p/20150318020014562.zip", "page_end_time": "2023-01-31", "page_name": "居家防疫攻略", "page_start_time": "2023-01-10", "terminal_type": "2", "tbk_pwd": "¥FWaGd5XQSyX¥", "ios_tbk_pwd": "67¥ CZ3457 FWaGd5XQSyX¥ https://m.tb.cn/h.Ul7RAC1 居家防疫攻略", "global_tbk_pwd": "6¥ CZ3457 FWaGd5XQSyX¥/" }, "request_id": "SrT16FH" }

错误码

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

在线
客服

会员请加QQ群交流:

微信
咨询

加微信咨询
顶部