全部
淘宝客
在线测试
淘宝客-服务商-所有订单查询
接口地址: http://api.vv-tool.com/tool/taobaoke/tbkdetails
接口介绍: 服务商使用。可通过该接口查询推广者账号下对应的推广订单明细。点击查看详情
必须用户授权 : 需要用户的授权,才能拿到被授权的数据
请求方式: POST
返回格式: JSON
接口收费: 联系运营
频率限制: 10 次/秒
请求头参数
参数 | 类型 | 必选 | 值 | 示例 |
---|---|---|---|---|
Authorization | string | 是 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx |
请求参数
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
query_type | Number | false | 1 | 查询时间类型,1:按照订单淘客创建时间查询,2:按照订单淘客付款时间查询,3:按照订单淘客结算时间查询,4:按照订单更新时间; |
position_index | String | false | 2222_334666 | 位点,除第一页之外,都需要传递;前端原样返回。 |
page_size | Number | false | 20 | 页大小,默认 20,1~100 |
member_type | Number | false | 2 | 推广者角色类型,2:二方,3:三方,不传,表示所有角色 |
tk_status | Number | false | 12 | 淘客订单状态,12-付款,13-关闭,14-确认收货,3-结算成功;不传,表示所有状态 |
end_time | String | true | 2019-04-23 12:28:22 | 订单查询结束时间,订单开始时间至订单结束时间,中间时间段日常要求不超过 3 个小时,但如 618、双 11、年货节等大促期间预估时间段不可超过 20 分钟,超过会提示错误,调用时请务必注意时间段的选择,以保证亲能正常调用! |
start_time | String | true | 2019-04-05 12:18:22 | 订单查询开始时间 |
jump_type | Number | false | 1 | 跳转类型,当向前或者向后翻页必须提供,-1: 向前翻页,1:向后翻页 |
page_no | Number | false | 1 | 第几页,默认 1,1~100 |
order_scene | Number | false | 1 | 场景订单场景类型,1:常规订单,2:渠道订单,3:会员运营订单,默认为 1 |
taobao_user_id | Int | true | 123 | 授权的用户 ID |
请求示例
{
"start_time": "2022-08-05 17:00:22",
"end_time": "2022-08-05 18:18:22",
"taobao_user_id": "1053992881"
}
请求代码示例
cURL请求代码示例
curl --location --request POST 'http://api.vv-tool.com/tool/taobaoke/tbkdetails' \
--header 'Authorization: Bearer XXXXXXXXXXXXXXXXXXXXXXX' \
--header 'Content-Type: application/json' \
--header 'Cookie: __yjs_duid=1_631b442499ed9f835d199def5892e4091628487614220; PHPSESSID=23cb193174e4095b141ccd6f6007733f; _csrf=2cd19402adae1c3113d9f645faab88a25cbaa984b70d96822c180b7eb5a081e2a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22yN3ZzOyIK8RcBRyag4P7WS66SlTkGj-Q%22%3B%7D' \
--data-raw '{
"start_time": "2022-08-01 11:00:22",
"end_time": "2022-08-01 12:18:22",
"taobao_user_id": "2208551696445"
}'
PHP请求代码示例
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'http://api.vv-tool.com/tool/taobaoke/tbkdetails',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS =>'{
"start_time": "2022-08-01 11:00:22",
"end_time": "2022-08-01 12:18:22",
"taobao_user_id": "2208551696445"
}',
CURLOPT_HTTPHEADER => array(
'Authorization: Bearer XXXXXXXXXXXXXXXXXXXXXXX',
'Content-Type: application/json',
'Cookie: __yjs_duid=1_631b442499ed9f835d199def5892e4091628487614220; PHPSESSID=23cb193174e4095b141ccd6f6007733f; _csrf=2cd19402adae1c3113d9f645faab88a25cbaa984b70d96822c180b7eb5a081e2a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22yN3ZzOyIK8RcBRyag4P7WS66SlTkGj-Q%22%3B%7D'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
JAVA请求代码示例
OkHttpClient client = new OkHttpClient().newBuilder()
.build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\r\n \"start_time\": \"2022-08-01 11:00:22\",\r\n \"end_time\": \"2022-08-01 12:18:22\",\r\n \"taobao_user_id\": \"2208551696445\"\r\n}");
Request request = new Request.Builder()
.url("http://api.vv-tool.com/tool/taobaoke/tbkdetails")
.method("POST", body)
.addHeader("Authorization", "Bearer XXXXXXXXXXXXXXXXXXXXXXX")
.addHeader("Content-Type", "application/json")
.addHeader("Cookie", "__yjs_duid=1_631b442499ed9f835d199def5892e4091628487614220; PHPSESSID=23cb193174e4095b141ccd6f6007733f; _csrf=2cd19402adae1c3113d9f645faab88a25cbaa984b70d96822c180b7eb5a081e2a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22yN3ZzOyIK8RcBRyag4P7WS66SlTkGj-Q%22%3B%7D")
.build();
Response response = client.newCall(request).execute();
响应参数
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
data | OrderPage | OrderPage | PublisherOrderDto |
results | PublisherOrderDto[] | PublisherOrderDto | PublisherOrderDto |
tb_paid_time | String | 2019-04-22 15:15:05 | 订单在淘宝拍下付款的时间 |
tk_paid_time | String | 2019-04-22 15:15:05 | 订单付款的时间,该时间同步淘宝,可能会略晚于买家在淘宝的订单创建时间 |
pay_price | String | 9.11 | 买家确认收货的付款金额(不包含运费金额) |
pub_share_fee | String | 0 | 结算预估收入 = 结算金额*提成。以买家确认收货的付款金额为基数,预估您可能获得的收入。因买家退款、您违规推广等原因,可能与您最终收入不一致。最终收入以月结后您实际收到的为准 |
trade_id | String | 294159887445064307 | 买家通过购物车购买的每个商品对应的订单编号,此订单编号并未在淘宝买家后台透出 |
tk_order_role | Number | 2 | 二方:佣金收益的第一归属者; 三方:从其他淘宝客佣金中进行分成的推广者 |
tk_earning_time | String | 2019-04-22 15:15:05 | 订单确认收货后且商家完成佣金支付的时间 |
adzone_id | Number | 11 | 推广位管理下的推广位名称对应的 ID,同时也是 pid=mm_1_2_3 中的“3”这段数字 |
pub_share_rate | String | 100 | 从结算佣金中分得的收益比率 |
refund_tag | Number | 0 | 维权标签,0 含义为非维权 1 含义为维权订单 |
subsidy_rate | String | 0 | 平台给与的补贴比率,如天猫、淘宝、聚划算等 |
tk_total_rate | String | 9.99 | 提成 = 收入比率*分成比率。指实际获得收益的比率 |
item_category_name | String | 淘小铺 | 商品所属的根类目,即一级类目的名称 |
seller_nick | String | -- | 掌柜旺旺 |
pub_id | Number | 98836808 | 推广者的会员 id |
alimama_rate | String | 0 | 推广者赚取佣金后支付给阿里妈妈的技术服务费用的比率 |
subsidy_type | String | -- | 平台出资方,如天猫、淘宝、或聚划算等 |
item_img | String | //img.alicdn.com/bao/uploaded/i1/2200782262419/O1CN01b5qlop1TjwarUo8fo_!!2200782262419.jpg | 商品图片 |
pub_share_pre_fee | String | 0 | 付款预估收入 = 付款金额*提成。指买家付款金额为基数,预估您可能获得的收入。因买家退款等原因,可能与结算预估收入不一致 |
alipay_total_price | String | 11.22 | 买家拍下付款的金额(不包含运费金额) |
item_title | String | tsh_rj_测试请不要拍_阶佣 11.1 | 商品标题 |
site_name | String | 合伙人 | 媒体管理下的对应 ID 的自定义名称 |
item_num | Number | 2 | 商品数量 |
subsidy_fee | String | 0 | 补贴金额 = 结算金额*补贴比率 |
alimama_share_fee | String | 0 | 技术服务费 = 结算金额收入比率技术服务费率。推广者赚取佣金后支付给阿里妈妈的技术服务费用 |
trade_parent_id | String | 294159887445064307 | 买家在淘宝后台显示的订单编号 |
order_type | String | 如意淘 | 订单所属平台类型,包括天猫、淘宝、聚划算等 |
tk_create_time | String | 2019-04-22 15:15:05 | 订单创建的时间,该时间同步淘宝,可能会略晚于买家在淘宝的订单创建时间 |
flow_source | String | -- | 产品类型 |
terminal_type | String | 无线 | 成交平台 |
click_time | String | 2019-04-22 15:14:55 | 通过推广链接达到商品、店铺详情页的点击时间 |
tk_status | Number | 13 | 已付款:指订单已付款,但还未确认收货 已收货:指订单已确认收货,但商家佣金未支付 已结算:指订单已确认收货,且商家佣金已支付成功 已失效:指订单关闭/订单佣金小于 0.01 元,订单关闭主要有:1)买家超时未付款; 2)买家付款前,买家/卖家取消了订单;3)订单付款后发起售中退款成功;3:订单结算,12:订单付款, 13:订单失效,14:订单成功 |
item_price | String | 2.1 | 商品单价 |
item_id | Number | 590141576510 | 商品 id |
adzone_name | String | 推广位管理下的自定义推广位名称 | |
total_commission_rate | String | 9.99 | 佣金比率 |
item_link | String | 商品链接 | |
site_id | Number | 45598009 | 媒体管理下的 ID,同时也是 pid=mm_1_2_3 中的“2”这段数字 |
seller_shop_title | String | -- | 店铺名称 |
income_rate | String | 9.99 | 订单结算的佣金比率 + 平台的补贴比率 |
total_commission_fee | String | 0 | 佣金金额 = 结算金额*佣金比率 |
tk_commission_pre_fee_for_media_platform | String | 1.05 | 预估内容专项服务费:内容场景专项技术服务费,内容推广者在内容场景进行推广需要支付给阿里妈妈专项的技术服务费用。专项服务费 =付款金额*专项服务费率。 |
tk_commission_fee_for_media_platform | String | 1.05 | 结算内容专项服务费:内容场景专项技术服务费,内容推广者在内容场景进行推广需要支付给阿里妈妈专项的技术服务费用。专项服务费 =结算金额*专项服务费率。 |
tk_commission_rate_for_media_platform | String | 0.01 | 内容专项服务费率:内容场景专项技术服务费率,内容推广者在内容场景进行推广需要按结算金额支付一定比例给阿里妈妈作为内容场景专项技术服务费,用于提供与内容平台实现产品技术对接等服务。 |
special_id | Number | 2323 | 会员运营 id |
relation_id | Number | 2323 | 渠道关系 id |
tk_deposit_time | String | 2019-09-09 12:01:01 | 预售时期,用户对预售商品支付定金的付款时间,可能略晚于在淘宝付定金时间 |
tb_deposit_time | String | 2019-09-09 12:01:01 | 预售时期,用户对预售商品支付定金的付款时间 |
deposit_price | String | 122.22 | 预售时期,用户对预售商品支付的定金金额 |
app_key | String | 112121 | 开发者调用 API 的 appkey |
alsc_id | String | 2332 | 口碑子订单号 |
alsc_pid | String | 32324 | 口碑父订单号 |
service_fee_dto_list | ServiceFeeDto[] | ServiceFeeDto | 服务费信息 |
share_relative_rate | String | 0.10 | 专项服务费率 |
share_fee | String | 11.11 | 结算专项服务费 |
share_pre_fee | String | 11.11 | 预估专项服务费 |
tk_share_role_type | Number | 122 | 专项服务费来源,122-渠道 |
lx_rid | String | 13123 | 激励池对应的 rid |
is_lx | String | 1 | 订单是否为激励池订单 1,表征是 0,表征否 |
marketing_type | String | 营销类型:该字段中视订单情况有单个或多个值。 例如:淘礼金(自助充值),特价版客户端染色,特价版客户端锁粉,特价版客户端推广。 | |
modified_time | String | 订单更新时间 | |
has_pre | Boolean | false | 是否还有上一页 |
position_index | String | 1555904214_lGltNdNvSX2 | 1555917305_lJfPMeFmdt2 |
has_next | Boolean | true | 是否还有下一页 |
page_no | Number | 1 | 页码 |
page_size | Number | 11 | 页大小 |
withholding_money | INT | 11 | 该接口扣费金额(点券) |
返回数据
{
"code": 0,
"msg": "成功",
"msec": 374,
"time": 1659950830,
"data": {
"request_id": "15rqapzkmv6ys",
"Body": "",
"data": {
"results": [
{
"tb_paid_time": "2022-08-05 17:07:02",
"tk_paid_time": "2022-08-05 17:07:14",
"pub_share_fee": "0.00",
"trade_id": "1634683908275542478",
"tk_order_role": 2,
"adzone_id": 74488900014,
"pub_share_rate": "100.00",
"refund_tag": 0,
"subsidy_rate": "0.00",
"tk_total_rate": "1.95",
"item_category_name": "咖啡/麦片/冲饮",
"seller_nick": "天猫超市",
"pub_id": 101807570,
"alimama_rate": "0.00",
"subsidy_type": "--",
"item_img": "//img.alicdn.com/tfscom/i4/6000000006296/O1CN01ANwKAS1wNcOyYkpkc_!!6000000006296-0-picassoopen.jpg",
"pub_share_pre_fee": "1.36",
"alipay_total_price": "69.66",
"item_title": "光明纯奶250mL*24盒苗条装早餐纯牛奶早餐奶牛奶",
"site_name": "技术随笔",
"item_num": 1,
"subsidy_fee": "0.00",
"alimama_share_fee": "0.00",
"trade_parent_id": "1634683908273542478",
"order_type": "聚划算",
"tk_create_time": "2022-08-05 17:07:02",
"flow_source": "--",
"terminal_type": "无线",
"click_time": "2022-08-05 16:33:25",
"tk_status": 12,
"item_price": "74.90",
"item_id": "583088863304",
"adzone_name": "推广链接94",
"total_commission_rate": "1.95",
"item_link": "http://item.taobao.com/item.htm?id=583088863304",
"site_id": 248750452,
"seller_shop_title": "天猫超市",
"income_rate": "1.95",
"total_commission_fee": "0.00",
"tk_commission_pre_fee_for_media_platform": "0.00",
"tk_commission_fee_for_media_platform": "0.00",
"tk_commission_rate_for_media_platform": "0.00",
"tk_deposit_time": "--",
"tb_deposit_time": "--",
"deposit_price": "0.00",
"is_lx": "0",
"marketing_type": "",
"modified_time": "2022-08-05 17:07:14"
},
{
"tb_paid_time": "2022-08-05 17:07:02",
"tk_paid_time": "2022-08-05 17:07:14",
"pub_share_fee": "0.00",
"trade_id": "1634683908274542478",
"tk_order_role": 2,
"adzone_id": 74488900014,
"pub_share_rate": "100.00",
"refund_tag": 0,
"subsidy_rate": "0.00",
"tk_total_rate": "1.35",
"item_category_name": "咖啡/麦片/冲饮",
"seller_nick": "天猫超市",
"pub_id": 101807570,
"alimama_rate": "0.00",
"subsidy_type": "--",
"item_img": "//img.alicdn.com/tfscom/i4/6000000005840/O1CN01Kv0aJQ1t0lnF0wOsp_!!6000000005840-0-picassoopen.jpg",
"pub_share_pre_fee": "0.17",
"alipay_total_price": "12.90",
"item_title": "怡宝饮用水 纯净水矿泉水 555ml*12瓶/组 量贩装包装瓶装",
"site_name": "技术随笔",
"item_num": 1,
"subsidy_fee": "0.00",
"alimama_share_fee": "0.00",
"trade_parent_id": "1634683908273542478",
"order_type": "天猫",
"tk_create_time": "2022-08-05 17:07:02",
"flow_source": "--",
"terminal_type": "无线",
"click_time": "2022-08-05 16:37:00",
"tk_status": 12,
"item_price": "19.90",
"item_id": "527894573302",
"adzone_name": "推广链接94",
"total_commission_rate": "1.35",
"item_link": "http://item.taobao.com/item.htm?id=527894573302",
"site_id": 248750452,
"seller_shop_title": "天猫超市",
"income_rate": "1.35",
"total_commission_fee": "0.00",
"tk_commission_pre_fee_for_media_platform": "0.00",
"tk_commission_fee_for_media_platform": "0.00",
"tk_commission_rate_for_media_platform": "0.00",
"tk_deposit_time": "--",
"tb_deposit_time": "--",
"deposit_price": "0.00",
"is_lx": "0",
"marketing_type": "",
"modified_time": "2022-08-05 17:07:14"
}
],
"has_pre": false,
"position_index": "1659690422_1WKRUUbRkIe2|1659690422_1WKRUUbVwRg2",
"has_next": false,
"page_no": 1,
"page_size": 20
},
"withholding_money": 0
}
}
响应代码
代码 | 代码描述 | 解决方案 |
---|---|---|
0 | 成功 | |
100 | 请求参数错误 | 检查您的请求参数是否正确 |
101 | 请求超时,请重试 | 检查您的网络情况或者联系客服解决 |
103 | 旺旺账号不存在 | 检查您输入的旺旺号是否正确 |
200 | 系统错误,请联系客服 | 检查您的接口地址填写是否正确,其他问题联系客服解决 |
202 | 系统错误,请稍后再试 | 稍后重试,或者联系对接群 |
203 | 暂不支持当前接口 | |
204 | 请求异常:无该接口权限,请前往官网开通正式接口。 | 前往官网开通该接口权限 |
204 | 请求异常:API 调用次数不足,请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
302 | 未授权店铺 | 根据返回链接进行扫码授权 |
401 | 身份凭证无效 | 在请求头中添加 access_token,重新更新 token |
404 | 请求路径或请求方式错误 | 请更换请求方式或者检查路径是否正确 |