公共参数
请求地址:https://console.open.onebound.cn/console/index.php?i=Anzexi
环境 | HTTP地址 | HTTPS地址 |
---|---|---|
正式环境 | http://gw.api.taobao.com/router/rest | https://eco.taobao.com/router/rest |
公共请求参数:
名称 | 类型 | 必须 | 描述 |
---|---|---|---|
method | String | 是 | API接口名称,例如:taobao.user.buyer.get |
app_key | String | 是 | TOP分配给应用的AppKey,例如:12345678 |
session | String | 否 | 用户登录授权成功后,TOP颁发给应用的授权信息,详细介绍请点击这里。当此API的标签上注明:“需要授权”,则此参数必传;“不需要授权”,则此参数不需要传;“可选授权”,则此参数为可选 |
timestamp | String | 是 | 时间戳,格式为yyyy-MM-dd HH:mm:ss,时区为GMT+8,例如:2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟 |
v | String | 是 | API协议版本,可选值:2.0 |
sign_method | String | 是 | 签名的摘要算法,可选值为:hmac,md5,hmac-sha256。 |
sign | String | 是 | API输入参数签名结果,签名算法介绍请点击这里 |
format | String | 否 | 响应格式。默认为xml格式,可选值:xml,json。 |
simplify | Boolean | 否 | 是否采用精简JSON返回格式,仅当format=json时有效,默认值为:false |
公共响应参数:
名称 | 类型 | 描述 |
---|---|---|
request_id | String | 平台颁发的每次请求访问的唯一标识 |
error_response | String | 请求访问失败时返回的根节点 |
code | String | 请求失败返回的错误码 |
msg | String | 请求失败返回的错误信息 |
sub_code | String | 请求失败返回的子错误码 |
sub_msg | String | 请求失败返回的子错误信息 |
***_response | String | 请求成功返回的根节点,'***' 为API名称的下划线模式 |
请求参数
名称
类型
必须
示例值
描述
fields
String
true
nick,sex
只返回nick, avatar参数
响应参数
名称
类型
示例值
描述
user
User
用户
nick
String
hz0799
用户昵称
avatar
String
http://assets.taobaocdn.com/app/sns/img/default/avatar-120.png
用户头像地址
sex
String
m
性别。可选值:m(男),f(女)
open_uid
String
324324324
对应账号的OpenUID
请求示例
JAVA
PHP
.NET
CURL
Python
NodeJS
C/C++
Python3
GO
PHP7
JAVA8
.NET6
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UserBuyerGetRequest req = new UserBuyerGetRequest();
req.setFields("nick,sex");
UserBuyerGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());
响应示例
XML
JSON
<user_buyer_get_response>
<user>
<nick>hz0799</nick>
<avatar>http://assets.taobaocdn.com/app/sns/img/default/avatar-120.png</avatar>
<sex>m</sex>
<open_uid>324324324</open_uid>
</user>
</user_buyer_get_response>
异常示例
XML
JSON
<error_response>
<code>50</code>
<msg>Remote service error</msg>
<sub_code>isv.invalid-parameter</sub_code>
<sub_msg>非法参数</sub_msg>
</error_response>