| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| method | String | 是 | API接口名称。 |
| app_key | String | 是 | TOP分配给应用的AppKey。 |
| session | String | 否 | 用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。 |
| timestamp | String | 是 | 时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。 |
| format | String | 否 | 响应格式。默认为xml格式，可选值：xml，json。 |
| v | String | 是 | API协议版本，可选值：2.0。 |
| partner_id | String | 否 | 合作伙伴身份标识。 |
| target_app_key | String | 否 | 被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。 |
| simplify | Boolean | 否 | 是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。 |
| sign_method | String | 是 | 签名的摘要算法，可选值为：hmac，md5。 |
| sign | String | 是 | API输入参数签名结果，签名算法介绍请点击这里。 |
a) 获取用户信息返回参数
|
1
2
3
4
5
6
7
|
<user_buyer_get_response> <user> <nick>hz0799</nick> <sex>m</sex> </user></user_buyer_get_response> |
错误参数包括错误主信息，错误子信息，如请求参数验证失败，则主信息提示参数错误，子信息包含具体哪个参数错误
a) solution：可选，给出解决错误的建议
b) code： 主错误信息，定义全局的错误编码
c) msg：错误原因
|
1
2
3
4
5
6
7
8
9
10
|
<error_response> <code>50</code> <msg>参数错误</msg> <solution></solution> <sub_errors> <sub_code>isv.invalid-parameter</sub_code> <sub_msg>用户名不能为空</sub_msg> <sub_solution>请填写用户名</sub_solution> </sub_errors></error_response> |
原文：http://www.cnblogs.com/gossip/p/5598602.html
