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 暂无

请求方式:GETPOST

请求参数

参数名称 参数类型 必填 示例值 描述
vekey String V123M56 公共参数,接口秘钥,请在会员中心获取
para String ¥TA1WdUtzfbP¥,PeDm2eMf3sDPQsPt6-eWVoD2fwJwHd 用英文逗号相连的各类产品类参数:如手淘分享的整段文案、或产品数字ID或字符串ID、或链接等十多种参数,参考指引说明,请urlencode编码后传参。请注意不支持商品数字IDtb.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时,请点此查看错误码表格

在线
客服

会员请加QQ群交流:

微信
咨询

加微信咨询
顶部