获取用户基本信息

跳转到: 导航, 搜索

获取用户基本信息

通过该接口,开发者可以获取自己微博账号粉丝的基本信息,包括昵称、头像、性别、所在城市、语言和关注时间等。

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