V兔API开放平台

全部

淘宝客

淘宝客-服务商-处罚订单查询

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

接口介绍： 服务商使用。可通过该接口查询推广者账号下在处罚管理后台，可直接下载的处罚订单明细。请注意：若是基于账号(member)、媒体 id(site)、推广位(adzone)、渠道方(relationid)维度的完整处罚，对应订单明细请根据处罚后台对应的处罚订单时间说明，在“推广订单明细”中筛选对应订单。点击查看详情

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

请求方式： POST

返回格式： JSON

接口收费： 联系运营

频率限制： 10 次/秒

请求头参数

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

请求参数

名称	类型	必须	示例值	描述
af_order_option	TopApiAfOrderOption	false		入参的对象
-relation_id	Number	false	2222	渠道关系 id
-tb_trade_id	Number	false	258897956183171983	子订单号
-tb_trade_parent_id	Number	false	258897956183171983	此参数不再使用，请勿入参
-page_size	Number	false	1	pagesize
-page_no	Number	false	10	pageNo
-span	Number	false	10	查询时间跨度，不超过 30 天，单位是天
-start_time	Date	false	2018-11-11 00:01:01	查询开始时间，以 taoke 订单创建时间开始
-special_id	Number	false	23132	此参数不再使用，请勿入参
-adzone_id	Number	false	123	pid 中的第三段，adzoneId
-site_id	Number	false	123	pid 中的第二段，siteId
-violation_type	Number	false	1	此参数不再使用，请勿入参
-punish_status	Number	false	1	此参数不再使用，请勿入参
taobao_user_id	Int	true	123	授权的用户 ID

请求示例

{

    "taobao_user_id": "1053992881"
}

请求代码示例

cURL请求代码示例

curl --location --request POST 'http://api.vv-tool.com/tool/taobaoke/tbkpunishorder' \
--header 'Authorization: Bearer XXXXXXXXXXXXXXXXXXXXXX' \
--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 '{
    "start_time": "2022-08-01 11:00:22",
    "taobao_user_id": "2208551696445",
    "adzone_id": 112049150197,
    "site_id": 2270750496
}'

PHP请求代码示例

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'http://api.vv-tool.com/tool/taobaoke/tbkpunishorder',
  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 =>'{
    "start_time": "2022-08-01 11:00:22",
    "taobao_user_id": "2208551696445",
    "adzone_id": 112049150197,
    "site_id": 2270750496
}',
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer XXXXXXXXXXXXXXXXXXXXXX',
    '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    \"start_time\": \"2022-08-01 11:00:22\",\r\n    \"taobao_user_id\": \"2208551696445\",\r\n    \"adzone_id\": 112049150197,\r\n    \"site_id\": 2270750496\r\n}");
Request request = new Request.Builder()
  .url("http://api.vv-tool.com/tool/taobaoke/tbkpunishorder")
  .method("POST", body)
  .addHeader("Authorization", "Bearer XXXXXXXXXXXXXXXXXXXXXX")
  .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		查询的对象
data	PageResult		结果
results	Result[]		处罚订单列表
union_id	String		淘宝联盟 unionid（该字段不再支持）
special_id	Number		会员运营 id（该字段不再支持）
relation_id	Number	122344	渠道关系 id
settle_month	Number	201812	结算月份
punish_status	String	0	处罚状态。0 冻结，1 解冻
violation_type	String	店铺淘宝客	处罚类型，目前包括 1:店铺淘宝客 2:订单虚假交易
tk_trade_create_time	String	2018-11-11 00:01:01	淘客订单创建时间
tb_trade_id	Number	581552321112183166	子订单号
tb_trade_parent_id	Number		父订单号（该字段不再支持）
tk_adzone_id	Number	1212	pid 里的 adzoneid
tk_site_id	Number	1212	pid 里的 siteid
tk_pub_id	Number	114469792	pid 里的 pubid
page_no	Number	1	翻页的 pageno
page_size	Number	10	翻页的 pagesie
total_count	Number	100	一共能查询出来的结果总数
biz_error_desc	String	没有获取到 memberid	业务出错的描述
biz_error_code	Number	103	业务出错的状态码
result_msg	String	ok	执行结果
result_code	Number	200	执行结果状态码
withholding_money	INT	11	该接口扣费金额（点券）

返回数据

{
    "code": 0,
    "msg": "操作成功",
    "msec": 1460,
    "time": 1617273033,
    "data": {
		"withholding_money": 1,
     "tbk_sc_punish_order_get_response":{
        "result":{
            "data":{
                "results":{
                    "result":[
                        {
                            "union_id":"",
                            "special_id":,
                            "relation_id":122344,
                            "settle_month":201812,
                            "punish_status":"0",
                            "violation_type":"店铺淘宝客",
                            "tk_trade_create_time":"2018-11-11 00:01:01",
                            "tb_trade_id":581552321112183166,
                            "tb_trade_parent_id":,
                            "tk_adzone_id":1212,
                            "tk_site_id":1212,
                            "tk_pub_id":114469792
                        }
                    ]
                },
                "page_no":1,
                "page_size":10,
                "total_count":100
            },
            "biz_error_desc":"没有获取到memberid",
            "biz_error_code":103,
            "result_msg":"ok",
            "result_code":200
        }
    }
}
}

响应代码

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