接口地址: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 | 参数传入错误_未知参数 | 检查参数类型是否正确 |