接口使用场景等说明:本接口近期下线,请尽快切换到新版万能转链接口 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转链接口。
环境 | http 地址 | https 地址 |
---|---|---|
正式环境 | http://api.veapi.cn/tbk/hcapi_v2 | 暂无 |
参数名称 | 参数类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
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 | 否 | 可不传或空 | 【已废弃,请勿用】场景参数 |
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参数 |
GET/POST http://api.veapi.cn/tbk/hcapi_v2?vekey=xxx¶=https://m.tb.cn/h.UPnQWRp&detail=1【例子】直接转链全段手淘分享文本
http://api.veapi.cn/tbk/hcapi_v2?vekey=xxx¶=97¥ CZ0001 SOS7defeKjf¥ https://m.tb.cn/h.URqhfIE 短袖t恤女白色纯棉(实际使用请对para参数url编码)【例子】转官方活动ID
http://api.veapi.cn/tbk/hcapi_v2?vekey=xxx¶=20150318020014562【例子】转官方活动链接或口令
http://api.veapi.cn/tbk/hcapi_v2?vekey=xxx¶=37¥ CZ0001 5ogHd5Xj2wq¥ https://m.tb.cn/h.UPnQWRp U选快抢
$api="http://api.veapi.cn/tbk/hcapi_v2?vekey=xxx¶=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; //返回值
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¶=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); } }
import requests # 要访问的API网页 target_url = "http://api.veapi.cn/tbk/hcapi_v2?vekey=xxx¶=https://m.tb.cn/h.UPnQWRp&detail=1" # 发送请求 response = requests.get(target_url) # 获取页面内容 if response.status_code == 200: print response.text
参数名称 | 参数类型 | 示例值 | 描述 |
---|---|---|---|
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" }