公共请求参数:
API请求工具
名称 | 类型 | 必须 | 描述 |
---|---|---|---|
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名称的下划线模式 |
请求参数
响应参数
请求示例
JAVA PHP NET CURL Python NodeJS C/C++ Python3 GO PHP7
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>