User.getInfo
出自Manyou开发者指南
目录 |
描述
返回指定用户的用户信息，返回形式为一个数组。数组中的信息会根据当前用户的不同而有所限制，当前用户根据参数 session_key 判断。
参数
| 必选性 | 参数名 | 类型 | 描述 | |
| 必选 | api_key | string | 申请应用时生成的 API Key。 | |
|---|---|---|---|---|
| session_key | string | 当前登录用户的 Session Key。 | ||
| call_id | float | 请求序列值。每个请求都有一个序列值，并且后一个比前一个大，序列值和 session 无关。我们建议您使用以毫秒为单位的当前时间的值，类似 PHP 中的 microtime(true) 函数。 | ||
| sig | string | MD5 串。根据当前请求和 Secret 值加密获得。 | ||
| v | string | 本参数的值必须设置为 1.0，表示 API 的版本号。 | ||
| uids | array | 用户 ID，彼此之间用逗号分割。 | ||
| fields | array | 指定返回用户的哪些信息。 | ||
| 可选 | format | string | 指定响应返回的格式。有 PHP (默认) 、 JSON 和 XML 这三种值可选。 |
请求范例
| 本例使用的是 PHP 客户端： // 实例化Manyou类库 $manyou = new Manyou($api_key, $api_secret); $manyou->api_client->user_getInfo(1591209, array('uid', 'name', 'site')); |
JSON返回结果范例
| [{"uid":"1591209","name":"snowrui","site":"100"}] |
返回值
返回的用户信息为该用户在当前 UCHome 站点对好友设置为可见的信息，如果根据传递的 uid 参数没有找到用户，此方法将返回一个空数组。以下是返回数组中的字段列表：
- uid - 用户在 Manyou 上的 ID。不论是否指定，此参数总是返回，并且为第一位。
- uch_id - 用户在 UCHome 上的 ID。
- name - UCHome 开启实名机制时返回用户实名，没有开启时返回用户名（同 handle）。
- handle - 用户名。
- site - 站点 ID。
- sex - 用户性别，返回值为 male 或 famale。
- birthday - 用户出生日期，返回值为 YYYY-MM-DD 格式，例如 1983-01-01。
- blood_type - 用户血型。
- relationship_status - 婚恋状态。
- current_location - 当前居住地。
- hometown_location - 家乡。
- has_added_app - 是否安装了当前应用，返回 0 时表示没有安装，返回 1 时表示已安装。
- admin_level - 用户权限信息。返回值为 ‘USER’ 时表示普通用户，返回为 ‘MANAGER’ 时表示为管理员，返回为 ‘FOUNDER’ 时表示创始人。
- pic - 用户大尺寸头像的地址（仅当用户头像存在时返回）。
- pic_thumb - 用户中尺寸头像的地址（仅当用户头像存在时返回）。
- pic_small - 用户小尺寸头像的地址（仅当用户头像存在时返回）。
另外，除了 uid 的所有返回字段都将根据被访问用户的隐私设置而有所限制。
最后，如果用户关闭了与 Manyou 平台的数据访问，那么查询用户资料时将不返回任何数据。
MYQL环境
本方法和以下 MYQL 查询效果相同( fields 为以上描述的字段)：
| SELECT uid, fields FROM user WHERE uid IN (uids) |
错误代码
| 错误代码 | 描述 | |
| 1 | 发生了一个未知错误，请重新提交请求。 | |
|---|---|---|
| 2 | 目前服务不可用。 | |
| 4 | 应用请求已达到最大允许请求次数。 | |
| 5 | IP 地址被禁止。 | |
| 100 | 无效的参数。 | |
| 101 | 无效的 API Key。 | |
| 102 | 无效或已超时的 Session Key。请将用户引导至登陆页面以获得一个新的 Session Key。 | |
| 104 | 无效的签名值。 |
