获取用户基本信息
(→注意事项) |
(→注意事项) |
||
| 第28行： | 第28行： | ||
*1、查看的用户必须是access_token中uid的粉丝； | *1、查看的用户必须是access_token中uid的粉丝； | ||
*2、access_token中的uid启用开发模式； | *2、access_token中的uid启用开发模式； | ||
| − | * | + | *3、如果开发者请求字段加了lang=zh_CN参数，则自动忽略该参数并且无需报错；如果lang=zh_TW或者lang=en，则需要报错（兼容微信） |
==返回结果== | ==返回结果== | ||
2014年5月4日 (日) 21:54的版本
获取用户基本信息
通过该接口，开发者可以获取自己微博账号粉丝的基本信息，包括昵称、头像、性别、所在城市、语言和关注时间等。
URL
https://api.weibo.com/2/eps/user/info.json
HTTP请求方式
GET
是否需要登录
是
关于登录授权，参见 如何登录授权
接口请求参数
参数详情：
| 必选 | 类型及范围 | 说明 | |
|---|---|---|---|
| access_token | true | string | 在粉丝服务平台 - 高级功能 - 开发者模式页面中获取，或者OAuth2.0授权后获得, 详细参考 获取粉丝服务平台开发接口的access token。 |
| uid | true | int64 | 需要查询的用户uid。 |
注意事项
- 1、查看的用户必须是access_token中uid的粉丝；
- 2、access_token中的uid启用开发模式；
- 3、如果开发者请求字段加了lang=zh_CN参数，则自动忽略该参数并且无需报错；如果lang=zh_TW或者lang=en，则需要报错（兼容微信）
返回结果
正常情况下，微博会返回下述JSON数据包：
{
"subscribe": 1,
"uid": "123123123",
"nickname": "punk",
"sex": 1,
"language": "zh_CN",
"city": "广州",
"province": "广东",
"country": "中国",
"headimgurl": "xxx",
"follow": "1",
"subscribe_time": 1382694957
}
参数说明：
| 返回值字段 | 字段类型 | 字段说明 |
|---|---|---|
| uid | int64 | 用户UID |
| nicname | string | 用户昵称 |
| sex | string | 性别，1：男、2：女、0：未知 |
| city | int | 用户所在城市ID
country? |
| province | int | 用户所在省级ID |
| location | string | 用户所在地 |
| language | string | 用户当前的语言版本，zh-cn：简体中文，zh-tw：繁体中文，en：英语 |
| headimgurl | string | 用户头像地址（中图），50×50像素 |
| name | string | 友好显示名称 |
| subscribe | boolean | 是否订阅 |
| follow_me | boolean | 该用户是否关注当前登录用户，true：是，false：否 |
| subscribe_time | string | 订阅时间 |
如果不是粉丝，则返回：
{
"follow": "0",
}
// 失败返回
{
"request": "/2/eps/user/info.json",
"error_code": 284XX,
"error": "error message."
}
