V兔API开放平台

全部

淘宝客

淘宝客-服务商-官方活动转链

接口地址： http://api.vv-tool.com/tool/taobaoke/tbkactivityget

接口介绍： 服务商使用。支持入参推广者对应的推广位和官方活动会场 ID，获取活动信息和推广者的推广链接，包含推广长链接、短链接、淘口令、微信推广二维码地址等。改该 API 支持二方、三方类型的转链。官方活动会场 ID，从淘宝客后台“我要推广-活动推广”中获取。点击查看详情

必须用户授权 : 需要用户的授权，才能拿到被授权的数据

请求方式： POST

返回格式： JSON

接口收费： 联系运营

频率限制： 10 次/秒

请求头参数

参数	类型	必选	值	示例
Authorization	string	是	授权 access_token	Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx

请求参数

名称	类型	必须	示例值	描述
activity_material_id	String	true	123	官方活动会场 ID，从淘宝客后台“我要推广-活动推广”中获取
adzone_id	Number	true	123	mm_xxx_xxx_xxx 的第 3 段数字
site_id	Number	true	123	mm_xxx_xxx_xxx 的第 2 段数字
relation_id	Number	false	123	渠道关系 id
union_id	String	false	demo	自定义输入串，英文和数字组成，长度不能大于 12 个字符，区分不同的推广渠道
taobao_user_id	Int	true	123	授权的用户 ID

请求示例

{
"adzone_id":102348550452,
"activity_material_id":"20150318020002597",
"site_id":250550471,
"taobao_user_id":1053992881
}

请求代码示例

cURL请求代码示例


curl --location --request POST 'http://api.vv-tool.com/tool/taobaoke/tbkactivityget' \
--header 'Authorization: Bearer XXXXXXXXXXXXXXXXXXXXX' \
--header 'Content-Type: application/json' \
--header 'Cookie: __yjs_duid=1_631b442499ed9f835d199def5892e4091628487614220' \
--data-raw '{
"adzone_id":102348550452,
"activity_material_id":"20150318020002597",
"site_id":250550471,
"taobao_user_id":1053992881
}'

PHP请求代码示例

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'http://api.vv-tool.com/tool/taobaoke/tbkactivityget',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
"adzone_id":102348550452,
"activity_material_id":"20150318020002597",
"site_id":250550471,
"taobao_user_id":1053992881
}',
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer XXXXXXXXXXXXXXXXXXXXX',
    'Content-Type: application/json',
    'Cookie: __yjs_duid=1_631b442499ed9f835d199def5892e4091628487614220'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

JAVA请求代码示例

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\r\n\"adzone_id\":102348550452,\r\n\"activity_material_id\":\"20150318020002597\",\r\n\"site_id\":250550471,\r\n\"taobao_user_id\":1053992881\r\n}");
Request request = new Request.Builder()
  .url("http://api.vv-tool.com/tool/taobaoke/tbkactivityget")
  .method("POST", body)
  .addHeader("Authorization", "Bearer XXXXXXXXXXXXXXXXXXXXX")
  .addHeader("Content-Type", "application/json")
  .addHeader("Cookie", "__yjs_duid=1_631b442499ed9f835d199def5892e4091628487614220")
  .build();
Response response = client.newCall(request).execute();

响应参数

名称	类型	示例值	描述
data	Data		返回结果对象
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	活动会场 A	会场名称
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	【本地化】微信小程序推广地址
withholding_money	INT	11	该接口扣费金额（点券）

返回数据

{
    "code": 0,
    "msg": "成功",
    "msec": 807,
    "time": 1659953643,
    "data": {
        "request_id": "15rk28aawlkeh",
        "Body": "",
        "data": {
            "wx_qrcode_url": "https://img.alicdn.com/imgextra/i1/6000000003886/O1CN01tZfYBZ1eZpst1Xpoa_!!6000000003886-0-o2oad.jpg",
            "click_url": "https://s.click.ele.me/t?union_lens=lensId%3AMAPI%401659953643%402108139e_0c2a_1827cf27e2f_1c5d%4001%3BeventPageId%3A20150318020002597&&e=-s025Wjs9m2UZC8cfM8AAkvarKe0kTnwJtNyKqa08lytEq0QRiW3SaY7hnk7RnVGATLhlZcLA62YyGSMJWIsERHaqPKGNcO3fLrtEYJhd4loNOspUm9fOePu5utvtLrCRWvJlsN3xNzLsBxaorlUdYgqdMGpM27apv6ei3CgGJQmYNC9AJwcjxjnc6lWF8PGI00twBKYJE2OtsmY2bQOCoyQcgXR4i3ixhrNaUQsjwTStx44kCtzMcKWUYfHxtLZXkRWo07PySvEfoQFNzMCBH5nrdbOlYKvEkqM3IXEvqvUjdSrYoGuNvU3XUJrLABQLNgDxYu4uoF4yX4RCkXaMk2Af4J7t8se44WXqlYJdpJioY4BjHYiZElqgDjMgyiIcMkY3Red8fNDKY3RZ28aeVTLs0EcRV5pQwQr9jR2yecYyyU3hEZ9pZb2aHhUKqn1siBPtevbdmiL4N081yHenjuLZCKvZQe0cAuHgXJfWfyL5aOyYe0hPDYgqHf8N0sejgTHmVytSep0rvlIeuMqFhtwaT2vG1&",
            "short_click_url": "https://s.click.ele.me/sRAshUu",
            "wx_miniprogram_path": "pages/sharePid/web/index?scene=https://s.click.ele.me/sRAshUu"
        },
        "withholding_money": 0
    }
}

响应代码

代码	代码描述	解决方案
0	成功
100	请求参数错误	检查您的请求参数是否正确
101	请求超时，请重试	检查您的网络情况或者联系客服解决
103	旺旺账号不存在	检查您输入的旺旺号是否正确
200	系统错误，请联系客服	检查您的接口地址填写是否正确，其他问题联系客服解决
202	系统错误，请稍后再试	稍后重试，或者联系对接群
203	暂不支持当前接口
204	请求异常：无该接口权限，请前往官网开通正式接口。	前往官网开通该接口权限
204	请求异常：API 调用次数不足，请前往网站兑换次数。	前往官网充值该接口调用次数
302	未授权店铺	根据返回链接进行扫码授权
401	身份凭证无效	在请求头中添加 access_token，重新更新 token
404	请求路径或请求方式错误	请更换请求方式或者检查路径是否正确