全部
淘宝客
在线测试

淘宝客-服务商-单品券高效转链


接口地址: 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 请求路径或请求方式错误 请更换请求方式或者检查路径是否正确