# 新用户订单明细查询
# 接口名称
taobao.tbk.dg.newuser.order.get
# 调用方法
https://api.taobaokeapi.com/?usertoken=[usertoken]&method=taobao.tbk.dg.newuser.order.get
# 请求参数
| 名称 | 类型 | 必须 | 示例值 | 描述 |
|---|---|---|---|---|
| page_size | Number | false | 20 | 页大小，默认20，1~100 |
| adzone_id | Number | false | 123 | mm_xxx_xxx_xxx的第三位 |
| page_no | Number | false | 1 | 页码，默认1 |
| start_time | Date | false | 2018-01-24 00:34:05 | 开始时间，当活动为淘宝活动，表示最早注册时间；当活动为支付宝活动，表示最早绑定时间；当活动为天猫活动，表示最早领取红包时间 |
| end_time | Date | false | 2018-01-24 00:34:05 | 结束时间，当活动为淘宝活动，表示最晚结束时间；当活动为支付宝活动，表示最晚绑定时间；当活动为天猫活动，表示最晚领取红包的时间 |
| activity_id | String | true | 119013_2 | 活动id， 活动名称与活动ID列表，请参见https://tbk.bbs.taobao.com/detail.html?appId=45301&postId=8599277 |
# 响应参数
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| results | Results | data | data |
| data | Data | data | |
| results | MapData[] | resultList | |
| register_time | Date | 2018-01-24 00:34:05 | 新注册时间，仅淘宝拉新适用 |
| bind_time | Date | 2018-01-24 00:34:05 | 当前活动为淘宝拉新活动时，bind_time为新激活时间； 当前活动为支付宝拉新活动时，bind_time为绑定时间。 |
| buy_time | Date | 2018-01-24 00:34:05 | 首购时间，仅淘宝，天猫拉新适用 |
| status | Number | 2 | 新人状态， 当前活动为淘宝拉新活动时，1: 新注册，2:激活，3:首购，4:确认收货； 当前活动为支付宝实名活动时，1：已绑定，2：拉新成功，3：无效用户；当前活动为支付宝新登活动时，3：手淘首购，4：手淘确认收货；当前活动为天猫拉新活动时，2:已领取，3:已首购，4:已收货 |
| mobile | String | 137****9999 | 新人手机号 |
| order_tk_type | Number | 1 | 订单淘客类型:1.淘客订单；2.非淘客订单，仅淘宝，天猫拉新适用 |
| union_id | String | 222222 | 分享用户(unionid)，仅淘宝，天猫拉新适用 |
| member_id | Number | 11 | 来源媒体ID(pid中mm_1_2_3)中第1位 |
| member_nick | String | 联盟官方账号 | 来源媒体名称 |
| site_id | Number | 11 | 来源站点ID(pid中mm_1_2_3)中第2位 |
| site_name | String | 联盟官方站点 | 来源站点名称 |
| adzone_id | Number | 3434 | 来源广告位ID(pid中mm_1_2_3)中第3位 |
| adzone_name | String | 联盟官方推广位 | 来源广告位名称 |
| tb_trade_parent_id | Number | 1112333 | 淘宝订单id，仅淘宝，天猫拉新适用 |
| accept_time | Date | 2018-01-24 00:34:05 | 确认收货时间，仅天猫拉新适用 |
| receive_time | Date | 2018-01-24 00:34:05 | 领取红包时间，仅天猫拉新适用 |
| success_time | Date | 2018-01-24 00:34:05 | 拉新成功时间，仅支付宝拉新适用 |
| activity_type | String | taobao | 活动类型，taobao-淘宝 alipay-支付宝 tmall-天猫 |
| activity_id | String | 119013_2 | 活动id |
| biz_date | String | 20180202 | 日期，格式为"20180202" |
| orders | OrderData[] | 复购订单，仅适用于手淘拉新 | |
| commission | String | 9.15 | 预估佣金 |
| confirm_receive_time | String | 20180204 | 收货时间 |
| pay_time | String | 20180203 | 支付时间 |
| order_no | String | 1589541350997963 | 订单号 |
| bind_card_time | Date | 2018-01-24 00:34:05 | 绑卡日期，仅适用于手淘拉新 |
| login_time | Date | 2018-01-24 00:34:05 | loginTime |
| is_card_save | Number | 1 | 银行卡是否是绑定状态：1-绑定，0-未绑定 |
| use_rights_time | Date | 2018-01-24 00:34:05 | 使用权益时间 |
| get_rights_time | Date | 2018-01-24 00:34:05 | 领取权益时间 |
| relation_id | String | 232342 | 渠道关系id |
| page_no | Number | 1 | 页码 |
| page_size | Number | 20 | 每页大小 |
| has_next | Boolean | true | 是否有下一页 |
# 响应示例
{
"tbk_dg_newuser_order_get_response":{
"results":{
"data":{
"results":{
"map_data":[
{
"register_time":"2018-01-24 00:34:05",
"bind_time":"2018-01-24 00:34:05",
"buy_time":"2018-01-24 00:34:05",
"status":2,
"mobile":"137****9999",
"order_tk_type":1,
"union_id":"222222",
"member_id":11,
"member_nick":"联盟官方账号",
"site_id":11,
"site_name":"联盟官方站点",
"adzone_id":3434,
"adzone_name":"联盟官方推广位",
"tb_trade_parent_id":1112333,
"accept_time":"2018-01-24 00:34:05",
"receive_time":"2018-01-24 00:34:05",
"success_time":"2018-01-24 00:34:05",
"activity_type":"taobao",
"activity_id":"119013_2",
"biz_date":"20180202",
"orders":{
"order_data":[
{
"commission":"9.15",
"confirm_receive_time":"20180204",
"pay_time":"20180203",
"order_no":"1589541350997963"
}
]
},
"bind_card_time":"2018-01-24 00:34:05",
"login_time":"2018-01-24 00:34:05",
"is_card_save":1,
"use_rights_time":"2018-01-24 00:34:05",
"get_rights_time":"2018-01-24 00:34:05",
"relation_id":"232342"
}
]
},
"page_no":1,
"page_size":20,
"has_next":true
}
}
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
# 异常示例
{
"error_response":{
"sub_msg":"非法参数",
"code":50,
"sub_code":"isv.invalid-parameter",
"msg":"Remote service error"
}
}
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
# 错误码解释
| 错误码 | 错误消息 | 解决方案 |
|---|---|---|
| isp.tbkapi-service-unavailable | 淘宝客API服务不可用 | 请稍后重试 |
| isv.invalid-parameter:start_price | 参数填写不正确 | 参数填写不正确 |
| isv.invalid-parameter:end_price | 参数填写不正确 | 参数填写不正确 |
| isv.invalid-parameter:end_tk_rate | 参数填写不正确 | 参数填写不正确 |
| 4 | 查询不到对应的adzoneId | 请检查adzoneId是否正确 |
| 2 | pid不正确 | 请检查是否输入了正确的adzoneId和siteId |
| isp.sys-error |