全部
淘宝客
在线测试
淘宝客-服务商-单品券高效转链
接口地址: http://api.vv-tool.com/tool/taobaoke/tbkprivilegeget
接口介绍: 单品券高效转链 API点击查看详情
必须用户授权 : 需要用户的授权,才能拿到被授权的数据
请求方式: POST
返回格式: JSON
接口收费: 联系运营
频率限制: 10 次/秒
请求头参数
参数 | 类型 | 必选 | 值 | 示例 |
---|---|---|---|---|
Authorization | string | 是 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx |
请求参数
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
adzone_id | Number | true | 123 | 推广位 id,mm_xx_xx_xx pid 三段式中的第三段 |
item_id | Number | false | 123 | 淘客商品 id |
platform | Number | false | 1 | 1:PC,2:无线,默认:1 |
site_id | Number | true | 1 | 备案的网站 id, mm_xx_xx_xx pid 三段式中的第二段 |
relation_id | String | false | 23223 | 渠道关系 ID,仅适用于渠道推广场景 |
special_id | String | false | 12345 | 会员运营 ID |
external_id | String | false | 12345 | 淘宝客外部用户标记,如自身系统账户 ID;微信 ID 等 |
xid | String | false | adsads | 团长与下游渠道合作的特殊标识,用于统计渠道推广效果 |
ucrowd_id | Number | false | 1 | 会员人群 ID,用于统计人群推广效果 |
get_topn_rate | Number | false | 0 | 是否获取前 N 件佣金 ,0-否,1-是,其他值-否 |
mini_program_link | Number | false | 0 | 是否需要获取小程序链接,需要设置 1。(暂未对外开放) |
taobao_user_id | Int | true | 123 | 授权的用户 ID |
请求示例
{
"adzone_id":102348550452,
"site_id":250550471,
"taobao_user_id":1053992881
}
请求代码示例
cURL请求代码示例
curl --location --request POST 'http://api.vv-tool.com/tool/taobaoke/tbkprivilegeget' \
--header 'Authorization: Bearer XXXXXXXXXXXXXXX' \
--header 'Content-Type: application/json' \
--header 'Cookie: __yjs_duid=1_631b442499ed9f835d199def5892e4091628487614220; PHPSESSID=23cb193174e4095b141ccd6f6007733f; _csrf=2cd19402adae1c3113d9f645faab88a25cbaa984b70d96822c180b7eb5a081e2a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22yN3ZzOyIK8RcBRyag4P7WS66SlTkGj-Q%22%3B%7D' \
--data-raw '{
"adzone_id":112049150197,
"site_id":2270750496,
"taobao_user_id":2208551696445
}'
PHP请求代码示例
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'http://api.vv-tool.com/tool/taobaoke/tbkprivilegeget',
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":112049150197,
"site_id":2270750496,
"taobao_user_id":2208551696445
}',
CURLOPT_HTTPHEADER => array(
'Authorization: Bearer XXXXXXXXXXXXXXX',
'Content-Type: application/json',
'Cookie: __yjs_duid=1_631b442499ed9f835d199def5892e4091628487614220; PHPSESSID=23cb193174e4095b141ccd6f6007733f; _csrf=2cd19402adae1c3113d9f645faab88a25cbaa984b70d96822c180b7eb5a081e2a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22yN3ZzOyIK8RcBRyag4P7WS66SlTkGj-Q%22%3B%7D'
),
));
$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\":112049150197,\r\n\"site_id\":2270750496,\r\n\"taobao_user_id\":2208551696445\r\n}");
Request request = new Request.Builder()
.url("http://api.vv-tool.com/tool/taobaoke/tbkprivilegeget")
.method("POST", body)
.addHeader("Authorization", "Bearer XXXXXXXXXXXXXXX")
.addHeader("Content-Type", "application/json")
.addHeader("Cookie", "__yjs_duid=1_631b442499ed9f835d199def5892e4091628487614220; PHPSESSID=23cb193174e4095b141ccd6f6007733f; _csrf=2cd19402adae1c3113d9f645faab88a25cbaa984b70d96822c180b7eb5a081e2a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22yN3ZzOyIK8RcBRyag4P7WS66SlTkGj-Q%22%3B%7D")
.build();
Response response = client.newCall(request).execute();
响应参数
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
result | RpcResult | 1 | result |
data | MaterialDto | 1 | data |
coupon_remain_count | Number | 6859 | 优惠券剩余量 |
coupon_total_count | Number | 8000 | 优惠券总量 |
coupon_info | String | 满 16 元减 10 元 | 优惠券面额 |
coupon_end_time | String | 2016-09-26 | 优惠券结束时间 |
coupon_start_time | String | 2016-09-25 | 优惠券开始时间 |
coupon_type | Number | 1 | 优惠券(商品优惠券推广链接中的券)类型,1 公开券,2 私有券,3 妈妈券 |
coupon_click_url | String | https://uland.taobao.com/coupon/edetail?e=nqUNB1NOF3Bt3vqbdXnGloankzPYmeEFkgNrw6YHQf9pZTj41Orn8MwBAs06HAOzqQomYNedOiHDYPmqkFXqLR0HgBdG%2FDDL%2F1M%2FBw7Sf%2FesGXLf%2BqX4cbeC%2F2cR0p0NlWH0%2BknxpnCJJP%2FQkZSsyo1HvKjXo4uz&pid=mm_26381042_12970066_52864659&af=1 | 商品优惠券推广链接 |
category_id | Number | 1 | 后台一级类目 |
max_commission_rate | String | 20.3 | 当不入参 special_id、relation_id、external_id 时,展示常规佣金率(%) |
item_id | Number | 524136796550 | 商品 id |
item_url | String | https://s.click.taobao.com/t?spm=a2e2e.10720394/c.90202110.1.4399704cUUhhH0&e=m%3D2%26s%3D0NJS731SUEdw4vFB6t2Z2ueEDrYVVa64LKpWJ%2Bin0XLjf2vlNIV67uIA4kDYDopEpOjgxi0uT208hw4H8GMUew7uoRPWrIBwR7CIpaNCoiKr9WTFywb%2BCtGNFs53xi4QGSKqJrqeJvt5ArodCWjzv9fsai3uVirbXH%2BQH9e66Y4%3D | 商品淘客链接 |
ysyl_click_url | String | https://uland.taobao.com/coupon/edetail?e=nqUNB1NOF3Bt3vqbdXnGloankzPYmeEFkgNrw6YHQf9pZTj41Orn8MwBAs06HAOzqQomYNedOiHDYPmqkFXqLR0HgBdG%2FDDL%2F1M%2FBw7Sf%2FesGXLf%2BqX4cbeC%2F2cR0p0NlWH0%2BknxpnCJJP%2FQkZSsyo1HvKjXo4uz&pid=mm_26381042_12970066_52864659&af=1 | 预售有礼-推广链接 |
ysyl_tlj_face | String | 0.6 | 预售有礼-预估淘礼金(元) |
ysyl_tlj_send_time | String | 2019-11-10 21:59:59 | 预售有礼-淘礼金发放时间 |
ysyl_tlj_use_start_time | String | 2019-11-10 21:59:59 | 预售有礼-淘礼金使用开始时间 |
ysyl_commission_rate | String | 20.3 | 预售有礼-佣金比例(%)( 预售有礼活动享受的推广佣金比例,注:推广该活动有特殊分成规则,请详见:https://tbk.bbs.taobao.com/detail.html?appId=45301&postId=9334376 ) |
ysyl_tlj_use_end_time | String | 2019-11-10 21:59:59 | 预售有礼-淘礼金使用结束时间 |
min_commission_rate | String | 20.3 | 当入参 special_id、relation_id、external_id 时,该字段展示预估最低佣金率(%) |
reward_info | Number | 1 | 比价场景专用,当系统检测到入参消费者 ID 购买当前商品会获得《天天开彩蛋》玩法的彩蛋时,该字段显示 1,否则为 0 |
topn_info | StepRateDto | 前 N 件佣金信息-当入参 get_topn_rate=1,前 N 件佣金生效且最高,透出该组字段 | |
topn_end_time | Number | 1937297392332 | 前 N 件佣金结束时间, 当前 N 件佣金 失效,本字段置空 |
topn_start_time | Number | 1937297392332 | 前 N 件佣金开始时间,当前 N 件佣金失效,本字段置空 |
topn_quantity | Number | 3000 | 前 N 件剩余库存,当前 N 件佣金失效,本字段置空 |
topn_total_count | Number | 3000 | 前 N 件初始总库存,当前 N 件佣金失效,本字段置空(失效:任务完成、时间结束、商品下架) |
mini_program | MiniProgramDto | 小程序链接(暂未对外开放) | |
mini_program_appid | String | xxxx | 小程序 APPID |
mini_program_path | String | pages/halo/itemdetail/index?id=xxx&miniAppScene=xxx | 小程序路径 |
mini_program_qrcode_url | String | xxxx | 小程序码 url 地址 |
withholding_money | INT | 11 | 该接口扣费金额(点券) |
返回数据
{
"code": 0,
"msg": "操作成功",
"msec": 1460,
"time": 1617273033,
"data": {
"withholding_money": 1,
"tbk_privilege_get_response":{
"result":{
"data":{
"coupon_remain_count":6859,
"coupon_total_count":8000,
"coupon_info":"满16元减10元",
"coupon_end_time":"2016-09-26",
"coupon_start_time":"2016-09-25",
"coupon_type":1,
"coupon_click_url":"https:\/\/uland.taobao.com\/coupon\/edetail?e=nqUNB1NOF3Bt3vqbdXnGloankzPYmeEFkgNrw6YHQf9pZTj41Orn8MwBAs06HAOzqQomYNedOiHDYPmqkFXqLR0HgBdG%2FDDL%2F1M%2FBw7Sf%2FesGXLf%2BqX4cbeC%2F2cR0p0NlWH0%2BknxpnCJJP%2FQkZSsyo1HvKjXo4uz&pid=mm_26381042_12970066_52864659&af=1",
"category_id":1,
"max_commission_rate":"20.3",
"item_id":524136796550,
"item_url":"https:\/\/s.click.taobao.com\/t?spm=a2e2e.10720394\/c.90202110.1.4399704cUUhhH0&e=m%3D2%26s%3D0NJS731SUEdw4vFB6t2Z2ueEDrYVVa64LKpWJ%2Bin0XLjf2vlNIV67uIA4kDYDopEpOjgxi0uT208hw4H8GMUew7uoRPWrIBwR7CIpaNCoiKr9WTFywb%2BCtGNFs53xi4QGSKqJrqeJvt5ArodCWjzv9fsai3uVirbXH%2BQH9e66Y4%3D",
"ysyl_click_url":"https:\/\/uland.taobao.com\/coupon\/edetail?e=nqUNB1NOF3Bt3vqbdXnGloankzPYmeEFkgNrw6YHQf9pZTj41Orn8MwBAs06HAOzqQomYNedOiHDYPmqkFXqLR0HgBdG%2FDDL%2F1M%2FBw7Sf%2FesGXLf%2BqX4cbeC%2F2cR0p0NlWH0%2BknxpnCJJP%2FQkZSsyo1HvKjXo4uz&pid=mm_26381042_12970066_52864659&af=1",
"ysyl_tlj_face":"0.6",
"ysyl_tlj_send_time":"2019-11-10 21:59:59",
"ysyl_tlj_use_start_time":"2019-11-10 21:59:59",
"ysyl_commission_rate":"20.3",
"ysyl_tlj_use_end_time":"2019-11-10 21:59:59",
"min_commission_rate":"20.3",
"reward_info":1,
"topn_info":{
"topn_end_time":1937297392332,
"topn_start_time":1937297392332,
"topn_quantity":3000,
"topn_total_count":3000
},
"mini_program":{
"mini_program_appid":"xxxx",
"mini_program_path":"pages\/halo\/itemdetail\/index?id=xxx&miniAppScene=xxx",
"mini_program_qrcode_url":"xxxx"
}
}
}
}
}
}
响应代码
代码 | 代码描述 | 解决方案 |
---|---|---|
0 | 成功 | |
100 | 请求参数错误 | 检查您的请求参数是否正确 |
101 | 请求超时,请重试 | 检查您的网络情况或者联系客服解决 |
103 | 旺旺账号不存在 | 检查您输入的旺旺号是否正确 |
200 | 系统错误,请联系客服 | 检查您的接口地址填写是否正确,其他问题联系客服解决 |
202 | 系统错误,请稍后再试 | 稍后重试,或者联系对接群 |
203 | 暂不支持当前接口 | |
204 | 请求异常:无该接口权限,请前往官网开通正式接口。 | 前往官网开通该接口权限 |
204 | 请求异常:API 调用次数不足,请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
302 | 未授权店铺 | 根据返回链接进行扫码授权 |
401 | 身份凭证无效 | 在请求头中添加 access_token,重新更新 token |
404 | 请求路径或请求方式错误 | 请更换请求方式或者检查路径是否正确 |