接口地址:http://api.tkurl.top/tbk_order_v2
返回格式:json
请求方式:GET
Session获取地址:http://api.tkurl.top/authorize?appkey=
请求示例:http://api.tkurl.top/tbk_order_v2?appkey=&end_time=2019-05-23 12:28:22&start_time=2019-04-23 12:18:22&&session=session
请求参数说明:
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
appkey | String | 必填 | 123456 | appkey |
session | String | 必填 | 授权后,再授权页面获取 。(有效期30天) | |
query_type | Number | 选填 | 1 | 查询时间类型,1:按照订单淘客创建时间查询,2:按照订单淘客付款时间查询,3:按照订单淘客结算时间查询 |
position_index | String | 选填 | 2222_334666 | 位点,除第一页之外,都需要传递;前端原样返回。 |
page_size | Number | 选填 | 20 | 页大小,默认20,1~100 |
member_type | Number | 选填 | 2 | 推广者角色类型,2:二方,3:三方,不传,表示所有角色 |
tk_status | Number | 选填 | 12 | 淘客订单状态,12-付款,13-关闭,14-确认收货,3-结算成功;不传,表示所有状态 |
end_time | String | 必填 | 2019-04-23 12:28:22 | 订单查询结束时间,订单开始时间至订单结束时间,中间时间段日常要求不超过3个小时,但如618、双11、年货节等大促期间预估时间段不可超过20分钟,超过会提示错误,调用时请务必注意时间段的选择,以保证亲能正常调用! |
start_time | String | 必填 | 2019-04-05 12:18:22 | 订单查询开始时间,需进行urlencode编码 |
jump_type | Number | 选填 | 1 | 跳转类型,当向前或者向后翻页必须提供,-1: 向前翻页,1:向后翻页 |
page_no | Number | 选填 | 1 | 第几页,默认1,1~100 |
order_scene | Number | 选填 | 1 | 场景订单场景类型,1:常规订单,2:渠道订单,3:会员运营订单,默认为1 |
{ "tbk_sc_order_details_get_response":{ "data":{ "results":{ "publisher_order_dto":[ { "tb_paid_time":"2019-04-22 15:15:05", "tk_paid_time":"2019-04-22 15:15:05", "pay_price":"9.11", "pub_share_fee":"0", "trade_id":"294159887445064307", "tk_order_role":2, "tk_earning_time":"2019-04-22 15:15:05", "adzone_id":11, "pub_share_rate":"100", "refund_tag":0, "subsidy_rate":"0", "tk_total_rate":"9.99", "item_category_name":"淘小铺", "seller_nick":"--", "pub_id":98836808, "alimama_rate":"0", "subsidy_type":"--", "item_img":"\/\/img.alicdn.com\/bao\/uploaded\/i1\/2200782262419\/O1CN01b5qlop1TjwarUo8fo_!!2200782262419.jpg", "pub_share_pre_fee":"0", "alipay_total_price":"11.22", "item_title":"tsh_rj_测试请不要拍_阶佣11.1", "site_name":"合伙人", "item_num":2, "subsidy_fee":"0", "alimama_share_fee":"0", "trade_parent_id":"294159887445064307", "order_type":"如意淘", "tk_create_time":"2019-04-22 15:15:05", "flow_source":"--", "terminal_type":"无线", "click_time":"2019-04-22 15:14:55", "tk_status":13, "item_price":"2.1", "item_id":590141576510, "adzone_name":"", "total_commission_rate":"9.99", "item_link":"", "site_id":45598009, "seller_shop_title":"--", "income_rate":"9.99", "total_commission_fee":"0", "tk_commission_pre_fee_for_media_platform":"1.05", "tk_commission_fee_for_media_platform":"1.05", "tk_commission_rate_for_media_platform":"0.01", "special_id":2323, "relation_id":2323, "tk_deposit_time":"2019-09-09 12:01:01", "tb_deposit_time":"2019-09-09 12:01:01", "deposit_price":"122.22", "app_key":"112121", "alsc_id":"2332", "alsc_pid":"32324", "service_fee_dto_list":{ "service_fee_dto":[ { "share_relative_rate":"0.10", "share_fee":"11.11", "share_pre_fee":"11.11", "tk_share_role_type":122 } ] }, "lx_rid":"13123", "is_lx":"1", "marketing_type":"", "modified_time":"" } ] }, "has_pre":false, "position_index":"1555904214_lGltNdNvSX2|1555917305_lJfPMeFmdt2", "has_next":true, "page_no":1, "page_size":11 } } }
{ "error_response":{ "msg":"Remote service error", "code":50, "sub_msg":"非法参数", "sub_code":"isv.invalid-parameter" } }
错误码 | 错误描述 | 解决方案 |
---|---|---|
602 | 权限到期 | 联系管理员开通 |
603 | 未找到用户或该用户未注册 | 请输入正确的appkey |
604 | 未知参数错误 | 建议加入重试机制 |
404 | 参数传入错误_未知参数 | 检查参数类型是否正确 |