淘宝客处罚订单查询
需要授权
2652人使用

淘宝联盟处罚订单查询API,可查询出被处罚、冻结的订单数据。

接口地址: http://api.tbk.dingdanxia.com/tbk/sc_punish_order 在线测试

接口支持https,非大陆服务器(含港澳台)调用接口会出现网络缓慢现象,请联系客服获取国外专线接口

请求参数、 调用方式 POST

参数接口

参数类型

必填

示例

说明

apikey

string

接口秘钥,请登录后台获取

span

Number

1200

查询时间跨度,不超过1小时,单位是秒

relation_id

Number

2222

渠道关系id

tb_trade_id

Number

258897956183171983

子订单号

page_size

Number

1

pagesize

page_no

Number

10

pageNo

start_time

Date

2018-11-11 00:01:01

查询开始时间,以taoke订单创建时间开始

punish_status

Number

1

处罚状态,0 正常,1 待处罚,2冻结

返回参数说明

标记

类型

例子

说明

relation_id

Number

122344

渠道关系id

settle_month

Number

201812

结算月份

punish_status

STRING

1

处罚状态,0 正常,1待处罚,2冻结

violation_type

STRING

2

处罚类型,1 店铺淘客,2其他

tk_trade_create_time

STRING

2018-11-11 00:01:01

淘客订单创建时间

tb_trade_id

Number

258897956183171983

子订单号

tk_adzone_id

Number

1212

pid里的adzoneid

tk_site_id

Number

1212

pid里的siteid

tk_pub_id

STRING

1212

pid里的pubid

返回示例
{
    "code": 200,
    "msg": "请求成功【success】",
    "data": [
        {
            "punish_status": "0",
            "relation_id": 2669886578,
            "settle_month": 202111,
            "tb_trade_id": 2259360075118304860,
            "tk_adzone_id": 111340050177,
            "tk_pub_id": 1368340106,
            "tk_site_id": 1991850209,
            "tk_trade_create_time": "2021-11-17 10:17:14",
            "violation_type": "店铺淘宝客(渠道方)"
        },
        {
            "punish_status": "0",
            "relation_id": 2669886578,
            "settle_month": 202111,
            "tb_trade_id": 2256522625713304860,
            "tk_adzone_id": 111340050177,
            "tk_pub_id": 1368340106,
            "tk_site_id": 1991850209,
            "tk_trade_create_time": "2021-11-16 14:52:28",
            "violation_type": "店铺淘宝客(渠道方)"
        }
    ]
}			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

登录后台查看接口秘钥是否一致

4003

参数不正确

请检查参数是否符合文档要求

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

查看签名构建规则确保正确无误。

4009

点卡已用完

请登录控制台-服务购买-充值点卡

4010

请购买接口次数包才能调用此接口

需充值次数包

4011

次数包已用完,请重新购买

需充值次数包

4012

请求客户端ip未加入白名单

将ip加入白名单

4013

联盟账号授权已过期

请登录控制台【授权管理】下重新授权您的相关账号

4014

PID异常

请登录控制台【授权管理】-【淘宝授权】,检查您的推广位PID是否填写,或是否填写正确。

4015

系统异常

服务端处理异常,请等待......或联系网站在线客服反馈。

4017

请求拒绝

调用请求被拒绝,您的账号状态存在异常,请联系平台管理员解除限制。