V兔API开放平台

电商工具接口电商导购接口物流发货接口

全平台ERP 仓库WMS 线上支付电商周边

全部

淘宝客

在线测试

淘宝客-服务商-权益物料精选

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

接口介绍： 服务商使用。支持入参推广者对应的“推广位”和官方提供的“权益物料 id”，获取指定权益物料。点击查看详情

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

请求方式： POST

返回格式： JSON

接口收费： 联系运营

频率限制： 10 次/秒

请求头参数

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

请求参数

名称	类型	必须	示例值	描述
page_size	Number	false	10	页大小，每次请求限制 10 以内
page_num	Number	false	1	第几页，默认：1
adzone_id	Number	true	123	mm_xxx_xxx_xxx 的第 3 段数字
promotion_id	Number	true	123	官方提供的权益物料 Id。有价券-37104、大额店铺券-37116，更多权益物料 id 敬请期待！
site_id	Number	true	111	mm_xxx_xxx_xxx 的第 2 段数字
taobao_user_id	Int	true	123	授权的用户 ID

请求示例

{
"adzone_id":102348550452,
"material_id":13366,
"site_id":250550471,
"taobao_user_id":1053992881
}

请求代码示例

cURL请求代码示例


curl --location --request POST 'http://api.vv-tool.com/tool/taobaoke/tbkpromotion' \
--header 'Authorization: Bearer xxxxxxxxxxxx' \
--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,
"promotion_id":1053992881
}'

PHP请求代码示例

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'http://api.vv-tool.com/tool/taobaoke/tbkpromotion',
  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,
"promotion_id":1053992881
}',
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer xxxxxxxxxxxx',
    '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\"promotion_id\":1053992881\r\n}");
Request request = new Request.Builder()
  .url("http://api.vv-tool.com/tool/taobaoke/tbkpromotion")
  .method("POST", body)
  .addHeader("Authorization", "Bearer xxxxxxxxxxxx")
  .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_list	MapData []		resultList
promotion_type	String	1	权益类型。1 有价券（需要购买的店铺券或单品券） 2 公开券（直接领取的店铺券或单品券） 3 妈妈券（妈妈渠道领取的店铺券或单品券） 4.品类券（跨店可用券，可与 1，2，3 叠加）
condition_type	String	1	优惠门槛类型： 1 满元 2 满件
discount_type	String	1	优惠类型： 1 减钱 2 打折
total_count	Number	50	权益信息-总量（权益初始库存量）
remain_count	Number	20	权益信息-剩余库存（权益剩余库存量）
display_start_time	String	1559232000000	权益信息展示开始时间，精确到毫秒时间戳
display_end_time	String	1559750399000	权益信息展示结束时间，精确到毫秒时间戳
promotion_list	PromotionList[]		权益信息
entry_used_start_time	String	1559232000000	权益开始时间，精确到毫秒时间戳
entry_used_end_time	String	1559750399000	权益结束时间，精确到毫秒时间戳
entry_condition	String	100	权益起用门槛，满 X 元可用，券场景为满元，精确到分，如满 100 元可用
entry_discount	String	30	权益面额，券场景为减钱，精确到分
promotion_extend	PromotionExtend		权益扩展信息
recommend_item_list	RecommendItemList[]		权益推荐商品
item_id	Number	123456	权益推荐商品 id
url	String	//s.click.taobao.com/xxx	商品链接
youjia_coupon_info	Youjiacouponinfo		有价券信息
item_id	String	123456	有价券商品 id
url	String	//s.click.taobao.com/xxx	商品链接
promotion_url	String	https://uland.taobao.com/quan/xxx	权益链接
seller_id	String	123	店铺信息-卖家 ID
nick	String	XXX 专营店	店铺信息-卖家昵称
shop_title	String	XXX 旗舰店	店铺信息-店铺名称
shop_picture_url	String	图片 url	店铺信息-店铺 logo
withholding_money	INT	11	该接口扣费金额（点券）

返回数据

{
    "code": 0,
    "msg": "操作成功",
    "msec": 1460,
    "time": 1617273033,
    "data": {
		"withholding_money": 1,
      "tbk_sc_optimus_promotion_response":{
        "result_list":{
            "map_data":[
                {
                    "promotion_type":"1",
                    "condition_type":"1",
                    "discount_type":"1",
                    "total_count":50,
                    "remain_count":20,
                    "display_start_time":"1559232000000",
                    "display_end_time":"1559750399000",
                    "promotion_list":{
                        "promotion_list":[
                            {
                                "entry_used_start_time":"1559232000000",
                                "entry_used_end_time":"1559750399000",
                                "entry_condition":"100",
                                "entry_discount":"30"
                            }
                        ]
                    },
                    "promotion_extend":{
                        "recommend_item_list":{
                            "recommend_item_list":[
                                {
                                    "item_id":123456,
                                    "url":"\/\/s.click.taobao.com\/xxx"
                                }
                            ]
                        },
                        "youjia_coupon_info":{
                            "item_id":"123456",
                            "url":"\/\/s.click.taobao.com\/xxx"
                        },
                        "promotion_url":"https:\/\/uland.taobao.com\/quan\/xxx"
                    },
                    "seller_id":"123",
                    "nick":"XXX专营店",
                    "shop_title":"XXX旗舰店",
                    "shop_picture_url":"图片url"
                }
            ]
        }
    }
}
}

响应代码

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