获取用户基本信息
通过该接口,开发者可以获取自己微博账号粉丝的基本信息,包括昵称、头像、性别、所在城市、语言和关注时间等。
URL
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."
}