API文档中心

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

淘客双11、双12、618等大促活动会场推广链接解析和转链接口

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

一、本接口用途：

1、专用于淘宝联盟每年双11、双12、双旦、年货节、38节、618等淘宝/天猫大促时的活动会场景页面生成您的推广链接。

2、淘宝联盟后台"活动中心——会场推广——官方活动"下所有活动转链专用的接口。

3、每年大促活动的超级红包转链接口。



二、活动转链接口增强：

本接口不仅直接可以转换会场ID，还可以解析转换已生成的活动会场淘口令、活动链接。大大增强您的应用处理用户转链能力。


【注意】

从2024年2月20号起，请添加参数 version=202402 参数更换到新版

调用说明

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

接口请求地址

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

请求方式：GET 或 POST

请求参数

参数名称 参数类型 必填 示例值 描述
vekey String 是 V123M56 公共参数，接口秘钥，请在会员中心获取
version String 否 202402 2024年2月切换新版用
activity_material_id String 是 20150318020014187 活动ID、或别人活动口令、链接的各类型参数，最多可传5个，用英文逗号分隔。
pid String 否 mm_11_22_33 要绑定这个活动的PID，必须，当会员中心授权有设置默认PID时，可不传。如果传了渠道relationId，则这里的PID参数必须是“渠道专属PID”
relationId String 否 5569425636 渠道关系ID
union_id String 否 demo 【废弃】自定义输入串，英文和数字组成，长度不能大于12个字符，区分不同的推广渠道
needtkl Number 否 0（默认） 可选值1或0，当您需要把生成的推广链接封装成淘口令，就传本参数。
shorturl String 否 0 【废弃】是否把长链click_url生成短链接，方便保存入库。可选值1或0，此时多一个字段click_url_short
sessionkey String 否 7002 多用户专用。如果您的会员卡是多用户版订单查询接口，若要查不同的帐号，请提供该帐号授权的sessionkey值
account_id String 否 联盟号id 会员中心有多个授权时，用本参数指定要查询哪一个联盟号id数据，联盟号ID请到会员中心授权页查看

请求示例

  • HTTP
  • PHP
  • JAVA
  • PYTHON
GET/POST  http://api.veapi.cn/tbk/activityinfo?vekey=xxx&pid=您的PID&activity_material_id=20150318020014187&relation_id=xxx&version=202402 

【例子】转换活动淘口令
http://api.veapi.cn/tbk/activityinfo?vekey=xxx&activity_material_id=￥ CZ0001 FJ2fdUB8Adi￥&version=202402


【例子】转换活动文案
http://api.veapi.cn/tbk/activityinfo?vekey=xxx&needtkl=1&activity_material_id=https://m.tb.cn/h.UOWBhit&version=202402（这里仅展示用，实际调用请对activity_material_id参数urlencode）
使用curl函数，curl不是php原生库，需要安装才能使用

$api="http://api.veapi.cn/tbk/activityinfo?vekey=xxx&pid=您的PID&activity_material_id=20150318020014187&relation_id=xxx&version=202402";

$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/activityinfo?vekey=xxx&pid=您的PID&activity_material_id=20150318020014187&relation_id=xxx&version=202402";
        // 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/activityinfo?vekey=xxx&pid=您的PID&activity_material_id=20150318020014187&relation_id=xxx&version=202402"

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

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

返回值（JSON）

参数名称 参数类型 示例值 描述
user_input_para String 217511031650548355 您传入的参数，当批量转链时，本参数可以对照您的入参。
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链接的长口令
material_type Number 1 1—单品 2—店铺 3—会场 4-承接开放 5-优惠券
page_id String 123456 活动会场ID
global_tbk_pwd String 5￥ CZ3457 K7bYdePXiZ8￥/ IOS和安卓通用的简单的店铺推广淘口令
wx_qrcode_url String https://img.alicdn.com/xxx 【旧版，废弃】【本地化】微信推广二维码地址
click_url String https://s.click.xx.xx/xxx?xx 【旧版，废弃】推广长链接
short_click_url String https://s.click.xx.xx/xxx?xx 【旧版，废弃】推广短链接
terminal_type String 1 【旧版，废弃】投放平台：1-PC，2-无线
material_oss_url String http://xxx.xxx.xxx 【旧版，废弃】物料素材下载地址
page_name String 优选全网低价 【旧版，废弃】会场名称
page_start_time String 2020-02-27 【旧版，废弃】活动开始时间
page_end_time String 2020-02-27 【旧版，废弃】活动结束时间
wx_miniprogram_path String pages/sharePid/web/index?scene=https://xxxx 【旧版，废弃】【本地化】微信小程序推广地址

返回示例

【提示】推广链接通常有时效性，示例中的链接为创建文档时生成，仅用于展示返回结果使用，有可能已失效。
{ "error": "0", "msg": "淘宝活动会场推广链接生成成功！", "all_row_num": 2, "err_row_num": 0, "data": [ { "user_input_para": "20150318020017989", "material_name": "活动会场转链", "cps_full_tpwd": "37￥ CA6496 UhHFWkzrVFR￥ https://m.tb.cn/h.5tGJdcc 开工酒水日", "cps_long_url": "https://s.click.taobao.com/t?union_lens=lensId%3AOPT%401708496610%40212b053a_1235_18dca556630_c67f%4001%40eyJmbG9vcklkIjo3MjQxMH0ie%3BeventPageId%3A20150318020017989&e=m%3D2%26s%3DIh%2F8o%2FsiX4xw4vFB6t2Z2iperVdZeJviPI5Rhak06vZnX1vWUft3ZWm1gDB6y4D6eiCUHET%2BS1sDLJ7ktrrIn7xURRXoB7JOcN94r5uYQPtTuM9zC0GRX5AM4KWtfYACrOqwIebF20i19w00la1fk5rpjhisw8I2gvBJl37sANfnou%2FYUQ8n5IrKOFR6umr2keMqUwSQcLQmkqLAwFV6f52mKRQSHwv9HnwLHhiT%2BLz2K47McS02JdxZMnZwXHuLcUEfihWP2N%2FTn1H0LeMc7bxURRXoB7JOcN94r5uYQPtTuM9zC0GRXwUKTrSiU41YWSlW6p18YPinkOxHolZil%2B3IKZcPpU0OJprbVzmT5j0JzCQPqUJ7KjCclrzRGqIlSG%2BB9F5gR1mSArLdsfNUpnDJvkttl6Yxk4d%2FKJlBb548SAlm%2B%2BnLpPCfvqdi4rJCceXoOEvSuweIAmafr1jw42hhyAe5%2Fkp7d%2FHKMrS70Tkc%2FEFYyJ2OBvU7qCiplqXWvoHjeLcrj2M1qO8LUvuMItBy4sQpnDVOF3BofYGCHje1F1Ih3l2O0GdzRCt8aaiWK0JzNP9ZL87N0sefRRlOrg%3D%3D", "cps_short_tpwd": "￥UhHFWkzrVFR￥", "cps_short_url": "https://s.click.taobao.com/mRGGRxt", "material_type": "3", "page_id": "20150318020017989", "global_tbk_pwd": "7￥ CA6496 UhHFWkzrVFR￥/" }, { "user_input_para": "https://s.click.taobao.com/5k6cyxt", "material_name": "活动会场转链", "cps_full_tpwd": "38￥ CZ0001 zXyLWkzJFyK￥ https://m.tb.cn/h.5GSct8t 新春开门红 自营个护", "cps_long_url": "https://s.click.taobao.com/t?union_lens=lensId%3AOPT%401708496610%40212b053a_1235_18dca556672_c682%4001%40eyJmbG9vcklkIjo3MjQxMH0ie%3BeventPageId%3A20150318020016647&e=m%3D2%26s%3DBsXebBIj1ONw4vFB6t2Z2iperVdZeJviU%2F9%2F0taeK29yINtkUhsv0KzezswPI0m4o3LXBIiwY9EL60FsZM9I2TIgTwpFUxJ%2BJzdJ3rdo4hcyJwaoKcyDsvAy%2Fay3dFHhcfoqCASFBE0Sylq0DylJrqED5kW4yHt0jidl2Va2D8n8vUvLpOt0bJMibMpkWOTSnsuZCKOWWOszuTGl041QArZl6wCRgzZSsd%2B%2Ff4Fhw9b%2BScqIfI2efLAHkyFZtBih5NH%2BHenq8WOJIurvXDm75QnfCJ26Jj8VMBl0JGONdzf4KMu5MdVMyHuQsPw1%2Bhf3KZiW5u6ljW214JFs5ulolGlIyJsrVTsqVV0ZGTryv1cmmttXOZPmPROj1Q9mghTsIYULNg46oBA%3D", "cps_short_tpwd": "￥zXyLWkzJFyK￥", "cps_short_url": "https://s.click.taobao.com/Zgwbyxt", "material_type": "3", "global_tbk_pwd": "6￥ CZ0001 zXyLWkzJFyK￥/" } ], "request_id": "fnLL5Jx" }

错误码

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

在线
客服

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

会员请加QQ群交流：

微信
咨询

加微信咨询
顶部