获取用户基本信息
| （未显示1个用户的18个中间版本） | |||
| 第1行： | 第1行： | ||
=获取用户基本信息= | =获取用户基本信息= | ||
| − | + | 通过该接口，开发者可以获取自己微博账号粉丝的基本信息，包括昵称、头像、性别、所在城市、语言和关注时间等。 | |
| − | + | ||
| − | + | ||
| − | + | ||
==URL== | ==URL== | ||
| − | https://api.weibo.com/2/eps/user/info | + | https://api.weibo.com/2/eps/user/info.json |
==HTTP请求方式== | ==HTTP请求方式== | ||
| 第25行： | 第22行： | ||
!width="75%" style="text-align:center;font-weight:bolder;border:1px solid #cccccc"|说明 | !width="75%" style="text-align:center;font-weight:bolder;border:1px solid #cccccc"|说明 | ||
{{api_args|access_token|true|string|在粉丝服务平台 - 高级功能 - 开发者模式页面中获取，或者OAuth2.0授权后获得, 详细参考 [[Messages_api/access_token|获取粉丝服务平台开发接口的access token]]。}} | {{api_args|access_token|true|string|在粉丝服务平台 - 高级功能 - 开发者模式页面中获取，或者OAuth2.0授权后获得, 详细参考 [[Messages_api/access_token|获取粉丝服务平台开发接口的access token]]。}} | ||
| − | {{api_args|uid| | + | {{api_args|uid|true|int64|需要查询的用户uid。}} |
| − | + | ||
|} | |} | ||
==注意事项== | ==注意事项== | ||
| − | * | + | *1、查看的用户必须是access_token中uid的粉丝； |
| + | *2、access_token中的uid启用开发模式； | ||
| + | *3、如果开发者请求字段加了lang=zh_CN参数，则自动忽略该参数并且无需报错；如果lang=zh_TW或者lang=en，则需要报错（兼容微信） | ||
==返回结果== | ==返回结果== | ||
| + | |||
| + | 如果请求参数uid是access_token中uid的粉丝，则微博会返回下述JSON数据包： | ||
| + | <pre> | ||
{ | { | ||
"subscribe": 1, | "subscribe": 1, | ||
| 第43行： | 第44行： | ||
"country": "中国", | "country": "中国", | ||
"headimgurl": "xxx", | "headimgurl": "xxx", | ||
| + | "headimgurl_large": "xxx", | ||
| + | "headimgurl_hd": "xxx", | ||
"follow": "1", | "follow": "1", | ||
"subscribe_time": 1382694957 | "subscribe_time": 1382694957 | ||
} | } | ||
| + | </pre> | ||
参数说明： | 参数说明： | ||
| 第53行： | 第57行： | ||
!width="15%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|字段类型 | !width="15%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|字段类型 | ||
!width="60%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|字段说明 | !width="60%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|字段说明 | ||
| + | {{rdes_args|subscribe|int|用户是否订阅该账号，值为0时，代表此用户没有订阅该账号；}} | ||
{{rdes_args|uid|int64|用户UID}} | {{rdes_args|uid|int64|用户UID}} | ||
{{rdes_args|nicname|string|用户昵称}} | {{rdes_args|nicname|string|用户昵称}} | ||
{{rdes_args|sex|string|性别，1：男、2：女、0：未知}} | {{rdes_args|sex|string|性别，1：男、2：女、0：未知}} | ||
| − | {{rdes_args|city| | + | {{rdes_args|city|string|用户所在城市}} |
| − | + | {{rdes_args|country|string|用户所在国家}} | |
| − | {{rdes_args| | + | {{rdes_args|province|int|用户所在省份}} |
| − | {{rdes_args| | + | {{rdes_args|language|string|用户当前的语言版本，zh_CN 简体，zh_TW 繁体，en英语}} |
| − | {{rdes_args|language|string| | + | |
{{rdes_args|headimgurl|string|用户头像地址（中图），50×50像素}} | {{rdes_args|headimgurl|string|用户头像地址（中图），50×50像素}} | ||
| − | {{rdes_args| | + | {{rdes_args|headimgurl_large|string|用户头像地址（大图），180×180像素}} |
| − | {{rdes_args| | + | {{rdes_args|headimgurl_hd|string|用户头像地址（高清），高清头像原图}} |
| − | + | ||
{{rdes_args|subscribe_time|string|订阅时间}} | {{rdes_args|subscribe_time|string|订阅时间}} | ||
| + | {{rdes_args|follow|int|该用户是否关注access_token中的uid，1：是，0：否}} | ||
|} | |} | ||
| + | |||
| + | 如果请求参数uid不是access_token中uid的粉丝，则返回： | ||
| + | <pre> | ||
| + | { | ||
| + | "follow": "0" //不同于微信subscribe=0就无法拉取其余信息，微博只有当follow=0时，也就是用户没有关注该账号时，才无法拉取其余信息； | ||
| + | } | ||
| + | </pre> | ||
// 失败返回 | // 失败返回 | ||
| + | <pre> | ||
{ | { | ||
"request": "/2/eps/user/info.json", | "request": "/2/eps/user/info.json", | ||
2014年5月4日 (日) 22:19的最后版本
获取用户基本信息
通过该接口，开发者可以获取自己微博账号粉丝的基本信息，包括昵称、头像、性别、所在城市、语言和关注时间等。
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，则需要报错（兼容微信）
返回结果
如果请求参数uid是access_token中uid的粉丝，则微博会返回下述JSON数据包：
{
"subscribe": 1,
"uid": "123123123",
"nickname": "punk",
"sex": 1,
"language": "zh_CN",
"city": "广州",
"province": "广东",
"country": "中国",
"headimgurl": "xxx",
"headimgurl_large": "xxx",
"headimgurl_hd": "xxx",
"follow": "1",
"subscribe_time": 1382694957
}
参数说明：
| 返回值字段 | 字段类型 | 字段说明 |
|---|---|---|
| subscribe | int | 用户是否订阅该账号，值为0时，代表此用户没有订阅该账号； |
| uid | int64 | 用户UID |
| nicname | string | 用户昵称 |
| sex | string | 性别，1：男、2：女、0：未知 |
| city | string | 用户所在城市 |
| country | string | 用户所在国家 |
| province | int | 用户所在省份 |
| language | string | 用户当前的语言版本，zh_CN 简体，zh_TW 繁体，en英语 |
| headimgurl | string | 用户头像地址（中图），50×50像素 |
| headimgurl_large | string | 用户头像地址（大图），180×180像素 |
| headimgurl_hd | string | 用户头像地址（高清），高清头像原图 |
| subscribe_time | string | 订阅时间 |
| follow | int | 该用户是否关注access_token中的uid，1：是，0：否 |
如果请求参数uid不是access_token中uid的粉丝，则返回：
{
"follow": "0" //不同于微信subscribe=0就无法拉取其余信息，微博只有当follow=0时，也就是用户没有关注该账号时，才无法拉取其余信息；
}
// 失败返回
{
"request": "/2/eps/user/info.json",
"error_code": 284XX,
"error": "error message."
}
文档更新时间: 2014-05-04
