淘客订单获取 免费
获取淘宝客推广订单明细
接口地址
| 请求方式 | 请求地址 |
|---|---|
| GET/POST | https://v1.oct.cn/taobao/orderget |
公共参数
| 参数 | 是否必须 | 示例值 | 说明 |
|---|---|---|---|
| appkey | 是 | test | 请求接口唯一凭证，前往接口中心获取：接口中心) |
业务参数
| 参数 | 是否必须 | 示例值 | 说明 |
|---|---|---|---|
| start_time | 是 | 2021-09-22 00:00:00 | 订单查询开始时间 |
| hasnext | 否 | all | 是否一次性拉取当前时间内的所有订单。默认获取当前时间段内的全部订单，当值为false时，只获取该时间段内的第一页数据，需手动判断返回参数是否还有数据，继续相同时间内的翻页查询。 |
| query_type | 否 | 1 | 查询时间类型，1：按照订单淘客创建时间查询，2:按照订单淘客付款时间查询，3:按照订单淘客结算时间查询，4:按照订单更新时间； |
| position_index | 否 | 1 | 位点，除第一页之外，都需要传递；仅在hasnext=false时有效 |
| page_size | 否 | 100 | 页大小，默认100，1~100 |
| member_type | 否 | 推广者角色类型,2:二方，3:三方，不传，表示所有角色 | |
| tk_status | 否 | 淘客订单状态，12-付款，13-关闭，14-确认收货，3-结算成功;不传，表示所有状态 | |
| end_time | 否 | 2021-09-22 00:20:00 | 订单查询结束时间，订单开始时间至订单结束时间，中间时间段日常要求不超过3个小时，但如618、双11、年货节等大促期间预估时间段不可超过20分钟，超过会提示错误，调用时请务必注意时间段的选择，以保证亲能正常调用！默认为开始时间+20分钟 |
| jump_type | 否 | 1 | 跳转类型，当向前或者向后翻页必须：-1: 向前翻页,1：向后翻页。默认1 |
| page_no | 否 | 1 | 第几页，默认1，1~100，仅在hasnext=false时有效 |
| order_scene | 否 | 1 | 场景订单场景类型，1:常规订单，2:渠道订单，3:会员运营订单，默认为1 |
返回说明
| 参数 | 类型 | 参考值 | 说明 |
|---|---|---|---|
| code | integer | 1000 | 1000成功 1001失败 |
| msg | string | 获取成功 | 具体提示信息 |
| data | Array | 对象或数组 | 业务具体参数 |
返回参数
{
"code":1000,
"msg":"获取成功",
"data":{
"has_next":false,//是否还有下一页
"has_pre":true,
"page_no":6,//总条数
"page_size":1,//当前时间段内的页数
"position_index":"1632240065_2x69RjFdL7R2|1632240065_2x69RjFdL7R2",
"results":{
"publisher_order_dto":[
{
"adzone_id":000000,
"adzone_name":"渠道专属_xxx",
"alimama_rate":"10.00",
"alimama_share_fee":"0.00",
"alipay_total_price":"0.01",
"app_key":"000000",
"click_time":"2021-09-21 23:34:05",
"deposit_price":"0.00",
"flow_source":"--",
"income_rate":"1.50",
"is_lx":"0",
"item_category_name":"其他",
"item_id":655794771467,
"item_img":"//img.alicdn.com/tfscom/i2/700459267/O1CN01NC0AV02IKL2z1X3cG_!!0-item_pic.jpg",
"item_link":"http://item.taobao.com/item.htm?id=655794771467",
"item_num":1,
"item_price":"9.90",
"item_title":"【会员0.01元加赠】清扬植觉头皮护理去屑洗发露强韧蓬松型100ml",
"marketing_type":"",
"modified_time":"2021-09-22 00:01:53",
"order_type":"天猫",
"pub_id":000,
"pub_share_fee":"0.00",
"pub_share_pre_fee":"0.00",
"pub_share_rate":"100.00",
"refund_tag":0,
"seller_nick":"联合利华官方旗舰店",
"seller_shop_title":"联合利华官方旗舰店",
"service_fee_dto_list":{
"service_fee_dto":[
{
"share_pre_fee":"0.00",
"share_relative_rate":"10.00",
"tk_share_role_type":122
}
]
},
"site_id":000000,
"site_name":"xxx",
"subsidy_fee":"0.00",
"subsidy_rate":"0.00",
"subsidy_type":"--",
"tb_deposit_time":"--",
"tb_paid_time":"2021-09-22 00:01:43",
"terminal_type":"无线",
"tk_commission_fee_for_media_platform":"0.00",
"tk_commission_pre_fee_for_media_platform":"0.00",
"tk_commission_rate_for_media_platform":"0.00",
"tk_create_time":"2021-09-22 00:01:49",
"tk_deposit_time":"--",
"tk_order_role":2,
"tk_paid_time":"2021-09-22 00:01:53",
"tk_status":12,
"tk_total_rate":"1.50",
"total_commission_fee":"0.00",
"total_commission_rate":"1.50",
"trade_id":"000",
"trade_parent_id":"000"
}
]
}
}
}请求示例
