接口地址:
http://api.web.ecapi.cn/taoke/tbkRefundOrderDetailsGet
接口实例:
http://api.web.ecapi.cn/taoke/tbkRefundOrderDetailsGet?apkey=登录会员中心查看&page_size=10&search_type=1&refund_type=0&start_time=2018-11-11 00:01:01&page_no=1&biz_type=1&tbname=xxxx
注意事项:如调用接口时数据返回异常,则需对接口中的【中文】及含有【空格】的数据进行Urlencode编码,然后再试。
请求方式:GET
会员范围:
付费会员 (新用户注册立刻送7天V1付费会员【注:赠送会员可使用全部接口,但调用频率与免费会员一致,免费会员调用频率可参考会员等级说明】)
必看注意:为保障接口安全及使用效率,调用本站接口前需先
添加IP白名单 (
IP地址测试),若IP不固定且无服务器,可通过“优惠推荐”中的链接购买阿里云服务器来调用接口。禁止以插件(包括但不仅限于浏览器插件及手机插件)形式使用接口,禁止将接口重新打包销售或转卖,一经发现,将做帐号封禁处理。
-
使用说明
-
-
请求参数
-
参数 |
类型 |
请求参数参考值 |
是否必须 |
说明 |
apkey |
String |
xxxxxxx |
是 |
用户中心 - 系统设置 - 平台设置 中查看APKEY密钥 (点我获取)(*必要) |
page_size |
Number |
10 |
是 |
每页数量 |
search_type |
Number |
1 |
是 |
1-维权发起时间,2-订单结算时间(正向订单),3-维权完成时间,4-订单创建时间,5-订单更新时间 |
refund_type |
Number |
0 |
是 |
1 表示2方,2表示3方,0表示不限 |
start_time |
String |
2018-11-11 00:01:01 |
是 |
开始时间,此时间需与search_type所对应时间类型匹配,否则可能查不到订单 |
page_no |
Number |
1 |
是 |
页码 |
biz_type |
String |
1 |
是 |
1代表渠道关系id,2代表会员关系id,3表示渠道+会员 |
tbname |
String |
xxxx |
是 |
在本平台授权的淘宝用户名,有中文时需进行Urlencode编码 |
-
返回参数
-
返回参数 |
类型 |
参数说明 |
扩展说明 |
data |
Json |
返回数据列表 |
|
├ page_no |
Number |
页码 |
|
├ page_size |
Number |
页大小 |
|
├ total_count |
Number |
总值 |
|
├ list |
Json |
订单列表 |
|
├ ├ tb_trade_parent_id |
Number |
淘宝订单编号 |
|
├ ├ special_id |
Number |
会员关系id |
|
├ ├ relation_id |
Number |
渠道关系id |
|
├ ├ tk3rd_pub_id |
Number |
第三方推广者memberid |
|
├ ├ tk_pub_id |
Number |
推广者memberid |
|
├ ├ tk_subsidy_fee_refund3rd_pub |
String |
第三方应该返还的补贴 |
|
├ ├ tk_commission_fee_refund3rd_pub |
String |
第三方应该返还的佣金 |
|
├ ├ tk_subsidy_fee_refund_pub |
String |
第二方应该返还的补贴(不包括技术服务费) |
|
├ ├ tk_commission_fee_refund_pub |
String |
第二方应该返还的佣金(不包括技术服务费) |
|
├ ├ tk_refund_suit_time |
String |
维权完成时间 |
|
├ ├ tk_refund_time |
String |
维权创建时间 |
|
├ ├ earning_time |
String |
订单结算时间 |
|
├ ├ tb_trade_create_time |
String |
订单创建时间 |
|
├ ├ refund_status |
Number |
维权状态 |
维权创建(淘客结算回执) 4,维权成功(淘客结算回执) 2,维权失败(淘客结算回执) 3,发生多次维权,待处理 11,从淘客处补扣(钱已结给淘客) 等待扣款 12,从淘客处补扣(钱已结给淘客) 扣款成功 13,从卖家处补扣(钱已结给卖家) 等待扣款 14,从卖家处补扣(钱已结给卖家) 扣款成功 15 |
├ ├ tb_auction_title |
String |
宝贝标题 |
|
├ ├ tb_trade_id |
Number |
淘宝子订单编号 |
|
├ ├ refund_fee |
String |
维权金额 |
|
├ ├ tb_trade_finish_price |
String |
结算金额 |
|
├ ├ tk_pub_show_return_fee |
String |
应返商家金额(二方) |
|
├ ├ tk3rd_pub_show_return_fee |
String |
应返商家金额(三方) |
|
├ ├ refund_type |
String |
1 表示2方,2表示3方 |
|
├ ├ alsc_pid |
String |
(口碑订单)口碑父订单号 |
|
├ ├ alsc_id |
String |
(口碑订单)口碑子订单号 |
|
-
Json返回示例
-
{"code":200,"data":{"list":[],"total_count":0,"page_no":1,"page_size":20},"msg":"success"}
-
code/http_status说明
-
code/http_status |
说明 |
200 |
数据获取成功 |
-1 |
数据获取失败 |
401 |
IP没有添加白名单 |
429 |
访问次数超限 |
403 |
关键参数丢失 |
405 |
请求方式不对 |