获取用户基本信息
第67行: | 第67行: | ||
{{rdes_args|headimgurl|string|用户头像地址(中图),50×50像素}} | {{rdes_args|headimgurl|string|用户头像地址(中图),50×50像素}} | ||
{{rdes_args|headimgurl_large|string|用户头像地址(大图),180×180像素}} | {{rdes_args|headimgurl_large|string|用户头像地址(大图),180×180像素}} | ||
− | {{rdes_args|headimgurl_hd|string|用户头像地址(高清),高清头像原图} | + | {{rdes_args|headimgurl_hd|string|用户头像地址(高清),高清头像原图}} |
{{rdes_args|subscribe_time|string|订阅时间}} | {{rdes_args|subscribe_time|string|订阅时间}} | ||
{{rdes_args|follow|int|该用户是否关注access_token中的uid,1:是,0:否}} | {{rdes_args|follow|int|该用户是否关注access_token中的uid,1:是,0:否}} |
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." }