全部
淘宝客
在线测试

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


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