API文档中心

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

新批量万能转链-支持批量商品、店铺、活动ID、淘口令、链接等

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

本接口和新万能转链generalconvert一样可以处理各类型参数，

本接口可以批量转链但不能处理以下2种类型的参数：

    1、商品数字ID转链。

    2、tb.cn的短链。

如有商品数字ID和tb.cn短链转链需求，请使用generalconvert转链接口


一次最大可以处理5个商品或物料（多个参数用英文逗号相隔），您可以综合传入各类型过滤的干净参数，可以是商品、店铺、会场等综合参数。参数形式也可以是字符串ID、链接，淘口令等综合。


【特别注意】

批量转链如果非全局错误，不会在error字段中提示，而是在data字段下单独列出（code和msg），方便您知道是哪个参数处理失败。请参考下文返回值示例

调用说明

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

接口请求地址

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

请求方式：GET 或 POST

请求参数

参数名称 参数类型 必填 示例值 描述
vekey String 是 V123M56 公共参数，接口秘钥，请在会员中心获取
para String 是 ￥TA1WdUtzfbP￥,PeDm2eMf3sDPQsPt6-eWVoD2fwJwHd 用英文逗号相连的各类产品类参数：如手淘分享的整段文案、或产品数字ID或字符串ID、或链接等十多种参数，参考指引说明，请urlencode编码后传参。请注意不支持商品数字ID和tb.cn短链类型的参数，这两种参数请用非批量的万能转链接口。
numidtype Number 否 1 由于本接口不支持商品数字ID转链，如果您传入的一些数字串，比如未加密的卖家ID（sellerid），有可能会被当成商品ID拒绝，这时您可以通过本参数告诉接口要如何处理传入的数字串，可选值类型：0-不支持（默认），1-指定数字串做为店铺ID，2-指定数字串做为活动ID。该参数不会影响会场ID和加密过的店铺卖家sellerid
account_id String 否 联盟帐号ID 联盟帐号ID值，当一个维易号会员中心有2个以上联盟授权时，本参数指定要转链的联盟号，这时pid参数要和联盟号一致。请到会员中心授权页查看联盟号ID值
sessionkey String 否 7002455622... 淘客授权字串,本参数仅限多用户版，当您的接口卡是多用户版时，请提供本参数和对应联盟号的Pid参数

请求示例

  • HTTP
  • PHP
  • JAVA
  • PYTHON
GET/POST  http://api.veapi.cn/tbk/plgeneralconvert?vekey=xxx&numidtype=1&para=20150318020017749,G5kyKBVc8tYeeqruYGoT0CJ-KM2qxeTwmwzqqJyi6,https://s.click.taobao.com/eU2SBzt 

【例子】批量转链并指定和商品数字ID相似的数字做为店铺ID处理
http://api.veapi.cn/tbk/plgeneralconvert?vekey=xxx&numidtype=1&para=20150318020017749,2089354788,G5kyKBVc8tYeeqruYGoT0CJ-KM2qxeTwmwzqqJyi6
使用curl函数，curl不是php原生库，需要安装才能使用

$api="http://api.veapi.cn/tbk/plgeneralconvert?vekey=xxx&numidtype=1&para=20150318020017749,G5kyKBVc8tYeeqruYGoT0CJ-KM2qxeTwmwzqqJyi6,https://s.click.taobao.com/eU2SBzt";

$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/plgeneralconvert?vekey=xxx&numidtype=1&para=20150318020017749,G5kyKBVc8tYeeqruYGoT0CJ-KM2qxeTwmwzqqJyi6,https://s.click.taobao.com/eU2SBzt";
        // 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/plgeneralconvert?vekey=xxx&numidtype=1&para=20150318020017749,G5kyKBVc8tYeeqruYGoT0CJ-KM2qxeTwmwzqqJyi6,https://s.click.taobao.com/eU2SBzt"

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

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

返回值（JSON）

参数名称 参数类型 示例值 描述
all_row_num Number 2 本次批量转链的记录数，包含失败数。上限是5个。
err_row_num Number 1 本次批量转链失败数。all_row_num-err_row_num即为成功数量。
user_input_para String 20150318020017749 是您传入的参数，用于判断该笔记录是这个入参生成的结果。
material_name String 活动会场转链 是该参数转链的类型
istaote Number 0 是否为淘特产品，0否，1是，用于判断你的APP等应用是要跳到手淘APP还是淘特APP
original_para_id String 56642522332 商品入参的原始商品ID
commission_rate String 6.00 佣金率
activity_id String 19d114f1a6464c98a30b01b3cb17dad6 优惠券ID
coupon_remain_count Number 99944 优惠券剩余数量
coupon_amount String 80.00 券面额
coupon_start_time String 2022-12-14 00:00:00 优惠券开始时间
coupon_end_time String 2022-12-20 23:59:59 优惠券结束时间
coupon_desc String 满129元减80元 优惠券信息，满XX元减XX元
coupon_type Number 0 0-店铺 1-单品，该字段不一定出现
coupon_short_tpwd String ￥p7lYdesjTCG￥ 商品、店铺或活动会场的二合一链接的短口令
coupon_short_url String https://s.click.taobao.com/DvHjOPu 二合一链接短链
coupon_full_tpwd String 47￥ CZ3457 p7lYdesjTCG￥ https://m.tb.cn/h.UQ4ceEA 爆肚粉香辣花甲 二合一链接的长口令
coupon_long_url String https://uland.taobao.com/coupon/edetail?e=.. 二合一长链接
material_id String 688401422805 物料ID，需根据material_type判断物料类型，可能为商品ID、卖家ID、会场ID
material_type Number 1 1—单品 2—店铺 3—会场 4-承接开放 5-优惠券
cps_long_url String https://s.click.taobao.com/t?e=m2.. 商品、店铺或活动会场的CPS链接长链
cps_short_tpwd String ￥zRmVdesjTCu￥ CPS链接的短口令
cps_short_url String https://s.click.taobao.com/CvHjOPu CPS链接短链
cps_full_tpwd String 39￥ CZ3457 zRmVdesjTCu￥ https://m.tb.cn/h.UQ4cewa 粉条六袋装 CPS链接的长口令
tk_biz_type Number 2 1-联盟口令，2-主站口令。入参物料不为淘口令时，此字段返回null
item_id String y387e62Ozub0TvtA-dAeOMBinu0 商品ID
seller_id String 123456 卖家ID
page_id String 20150318020014311 会场ID
isv_mktid String aisjd8-8asdbaiu 根据入参工具服务商账号信息生成的新商品ID
tpwd_origin_url String https://item.taobao.com/item.htm?ut_sk=1.Xhm.. 淘口令原始链接，入参物料不为淘口令时，此字段返回null
code String 401 淘宝联盟官方的错误码，当参数处理失败时才会返回该参数（请参考下文示例）
msg String 该口令无效，请检查后重新提交 淘宝联盟官方的错误描述，当参数处理失败时才会返回该参数

返回示例

【提示】推广链接通常有时效性，示例中的链接为创建文档时生成，仅用于展示返回结果使用，有可能已失效。
{ "error": "0", "msg": "批量转链成功！", "result": 0, "all_row_num": 4, "err_row_num": 1, "repeat_row_num": 0, "data": [ { "user_input_para": "20150318020017749", "material_name": "活动会场转链", "cps_full_tpwd": "28￥ CA6496 gYy0Wkto6Oa￥ https://m.tb.cn/h.5GdNQaL 3元3件", "cps_long_url": "https://s.click.taobao.com/t?union_lens=lensId%3AOPT%401708421168%4021669ebf_124c_18dc5d63e5f_7134%4001%40eyJmbG9vcklkIjo3MjQxMH0ie%3BeventPageId%3A20150318020017749&e=m%3D2%26s%3DhDuf21ou%2FT9w4vFB6t2Z2iperVdZeJviPI5Rhak06vZnX1vWUft3ZWqiX7DxK82KcdL9K%2BPtJJQDLJ7ktrrIn7xURRXoB7JOcN94r5uYQPtTuM9zC0GRX5AM4KWtfYACrOqwIebF20i19w00la1fkzR6jBSLYg3tp4Ih1pPLsSUu9HP6WyfoZuei79hRDyfkiso4VHq6avaR4ypTBJBwtPIcvT56TvpnKVffChNb96kj5Wjhls5eJEMaiXin%2B3ZohOvdTv9SvjMBR0juSzMWOSG6hRgnAnWDFO6BBKKuU7aW2ZhEEEGvs9FIZCnIMl5KMPRpQyEY6ePSWrd6kqBPm9veb2fK04w9yb3L%2FqGwzOvYuopIMjmrp2DGGo%2F4OAdGoPaDLlRzquGYNUxbDcCJB%2Bd7Md9rDGnaWASawB3PZvGPxlqHidOMD%2BxcSUtQL4xj2NNwMo66aKT87aPM9nT4k5UoInqJzDTrqzocOMJbWC75T5faue2G3cIPg2VdxElGKzxPLcrwwzy9L5o%2Flca4BMO4wdctf5YcclMy%2FAIIL6ifj8EI5hwm2Lvht4fKLuDeR%2FICyNjq9Bep3SRkN9cjC%2BvJRZdIgmf08opbsIjyG5hn9F4AEWlpu2OHuAwDJLdg158qROwFt0RPtx0Qs0xrF%2B6nlMpVnOk0l93MMi05QIbEkZ6w6zahxsYMXU3NNCg%2F", "cps_short_tpwd": "￥gYy0Wkto6Oa￥", "cps_short_url": "https://s.click.taobao.com/YBvj4yt", "material_type": "3", "page_id": "20150318020017749" }, { "user_input_para": "G5kyKBVc8tYeeqruYGoT0CJ-KM2qxeTwmwzqqJyi6", "material_name": "商品转链", "commission_rate": "0.60", "coupon_full_tpwd": "87￥ HU9046 gUEhWktM7uJ￥ https://m.tb.cn/h.5uiD5zi 【日期新鲜】认养一头牛全脂纯牛奶250ml*12盒*2整箱儿童学生营养", "coupon_long_url": "https://uland.taobao.com/coupon/edetail?e=0lgFkiE%2FKOClhHvvyUNXZfh8CuWt5YH5OVuOuRD5gLJMmdsrkidbOWgpcJRl3wFwcV%2FlEyhmp8Cco94KkfL5V1yk0nxC77GDQ9LxeDm4WUheJ7u4UUbqmelweDMrzhs3P%2FgiyMFkyweQIOCm%2F3R6OHIE4r7wqPNKbTFatlyBSzYuqY9NGNlhmkSRZbi7YBRvVD43zPnxME4pKmNxHz0%2BQ7tB9I88Z4Zpa27YjMv52CA2ekPmlbCiqZqvv5huQJXayb9riMRBqph2zIbJA0ocBbcZelJt%2Bzjy3QqA5LDBTDsh90YH8FidF9gPnqZJI4t0dFSlC4H6CgaIWqMsOMORj1kT%2Burs3qO2&traceId=210761d217084211685025942e1e52&&union_lens=lensId:TAPI@1708421168@216730a1_1125_18dc5d63db8_9ced@01", "coupon_short_tpwd": "￥gUEhWktM7uJ￥", "coupon_short_url": "https://s.click.taobao.com/JOgj4yt", "cps_full_tpwd": "17￥ CZ3460 MTZlWktMZs3￥ https://m.tb.cn/h.5GdnJey 【日期新鲜】认养一头牛全脂纯牛奶250ml*12盒*2整箱儿童学生营养", "cps_long_url": "https://s.click.taobao.com/t?e=m%3D2%26s%3DgxsLNI0hnUlw4vFB6t2Z2ueEDrYVVa64XoO8tOebS%2BdRAdhuF14FMSnB8D6%2B%2Bbo4MMgx22UI05YNx086yGXKPm3yp02FtiUkuEHV73KYXCORJkMnNrcwP4VwhIsr1DlAgb9ZeSZXs4qHCrUnhnpwgM%2FrSkPyMeX%2BOemaFM5tHHZIVEiHQ62N5LVgCn4cffwi2c9lclobwgMbGNYlHHooptAHWHuwJT%2FvGQ01GHT29wYQA60iBc0rz2JA3LqSUge9KgvBhrLSERf%2FVeV2fAquMOkm9mtAo7fvhYuFeSgaZjLzeq1NhQ8uk7R58urGrTsBkyJsymRY5NJRLBgaW5udaw%3D%3D&union_lens=lensId:TAPI@1708421168@216730a1_1125_18dc5d63db8_9ced@01", "cps_short_tpwd": "￥MTZlWktMZs3￥", "cps_short_url": "https://s.click.taobao.com/Zz0SXxt", "istaote": 0, "isv_mktid": "OqnMrYqCzt3M36YU4yRsMtJ-JAgw03TM0MAbbgXuvj", "item_id": "736x8pqu4t5MAnmrXyUZANHgUV-JAgw03TM0MAbbgXuvj", "material_type": "1" }, { "user_input_para": "￥REfHWk1BbRd￥", "material_name": "错误，无法解析", "code": "401", "msg": "该口令无效，请检查后重新提交" }, { "user_input_para": "2089354788", "material_name": "店铺转链", "cps_full_tpwd": "08￥ CA6496 wer5WktovA1￥ https://m.tb.cn/h.5uiEGZw 品诺美数码专营店", "cps_long_url": "http://s.click.taobao.com/t?e=m%3D2%26s%3DQvv%2FRcwgO%2Bdw4vFB6t2Z2jAVflQIoZepyK8Cckff7TVRAdhuF14FMSnB8D6%2B%2Bbo4MMgx22UI05YNx086yGXKPm3yp02FtiUkuEHV73KYXCORJkMnNrcwP2R7gWXkfoLCfrsVv14yyKKJIhDBLrTPc3EqY%2Bakgpmw&union_lens=lensId:TAPI@1708421168@21669ebf_124c_18dc5d63e2d_c2c7@01", "cps_short_tpwd": "￥wer5WktovA1￥", "cps_short_url": "https://s.click.taobao.com/Nz0SXxt", "material_type": "2", "seller_id": "180285409912306816" } ], "request_id": "ynYw9yE" }

错误码

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

在线
客服

点此【QQ在线咨询】QQ号：3252444923

会员请加QQ群交流：

微信
咨询

加微信咨询
顶部