淘宝客处罚订单查询

高级接口

请求方法

接口地址:http://api.tkurl.top/api/alimama/punishorder

支持格式:json

请求方式:get

Session获取地址:http://api.tkurl.top/authorize?appkey=

请求示例:http://api.tkurl.top/api/alimama/punishorder?Appkey=&session=

请求参数说明:

名称 类型 是否必须 示例值 描述
Appkey String 必填 123456 appkey
session String 必填 授权后,再授权页面获取 。(有效期30天)
site_id int 可选 123 pid中的第二段,siteId
adzone_id int 可选 123 pid中的第三段,adzoneId
span int 可选 10 查询时间跨度,不超过30天,单位是天
relation_id int 可选 222222 渠道关系id
tb_trade_id int 可选 258897956183171983 子订单号
page_size int 可选 1 pagesize
page_no int 可选 10 page_no
start_time Date 可选 2018-11-11 00:01:01 查询开始时间,以taoke订单创建时间开始

响应参数

名称
类型
示例值
描述
result
RpcResult
查询的对象
data
PageResult
结果
page_no
Number
1
翻页的pageno
page_size
Number
10
翻页的pagesie
total_count
Number
100
一共能查询出来的结果总数
results
Result[]
处罚订单列表
relation_id
Number
122344
渠道关系id
settle_month
Number
201812
结算月份
tk_trade_create_time
String
2018-11-11 00:01:01
淘客订单创建时间
tb_trade_parent_id
Number
父订单号(该字段不再支持)
special_id
Number
会员运营id(该字段不再支持)
union_id
String
淘宝联盟unionid(该字段不再支持)
punish_status
String
0
处罚状态。0 冻结,1 解冻
violation_type
String
店铺淘宝客
处罚类型,目前包括 1:店铺淘宝客 2:订单虚假交易
tb_trade_id
Number
581552321112183166
子订单号
tk_adzone_id
Number
1212
pid里的adzoneid
tk_site_id
Number
1212
pid里的siteid
tk_pub_id
Number
114469792
pid里的pubid
biz_error_desc
String
没有获取到memberid
业务出错的描述
biz_error_code
Number
103
业务出错的状态码
result_msg
String
ok
执行结果
result_code
Number
200
执行结果状态码

响应示例

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

异常示例

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}
   

错误码解释

错误码 错误描述 解决方案
isv.invalid-parameter 参数填写不正确 参数填写不正确
603 未找到用户或该用户未注册 请输入正确的appkey
604 未知参数错误 建议加入重试机制
404 参数传入错误_未知参数 检查参数类型是否正确