Weibo Platform Logo

微博开放平台

weibo

获取用户基本信息

跳转到： 导航, 搜索
(→返回结果)
 
（未显示1个用户的21个中间版本）
第1行： 第1行：
 
=获取用户基本信息=
 
=获取用户基本信息=
−
在关注者与公众号产生消息交互后，公众号可获得关注者的OpenID（加密后的微信号，每个用户对每个公众号的OpenID是唯一的。对于不同公众号，同一用户的openid不同）。公众号可通过本接口来根据OpenID获取用户基本信息，包括昵称、头像、性别、所在城市、语言和关注时间。
+
通过该接口，开发者可以获取自己微博账号粉丝的基本信息，包括昵称、头像、性别、所在城市、语言和关注时间等。
−
 
+
−
开发者可通过uid来获取用户基本信息。
+
−
 
+
  
 
==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|false|int64|需要查询的用户uid。}}
+
{{api_args|uid|true|int64|需要查询的用户uid。}}
−
{{api_args|lang|true|string|场景值ID，临时二维码时为32位非0整型，永久二维码时最大值为100000（目前参数只支持1--100000）。}}
+
 
|}
 
|}
  
 
==注意事项==
 
==注意事项==
−
*1、如果action_name=QR_SCENE时，expire_seconds参数空缺，则默认为1800；
+
*1、查看的用户必须是access_token中uid的粉丝；
−
*2、目前有2种类型的二维码，分别是临时二维码和永久二维码，前者有过期时间，最大为1800秒，但能够生成较多数量，后者无过期时间，数量较少（目前参数只支持1--100000）；
+
*2、access_token中的uid启用开发模式；
−
 
+
*3、如果开发者请求字段加了lang=zh_CN参数，则自动忽略该参数并且无需报错；如果lang=zh_TW或者lang=en，则需要报错（兼容微信）
  
 
==返回结果==
 
==返回结果==
 +
 +
如果请求参数uid是access_token中uid的粉丝，则微博会返回下述JSON数据包：
 +
<pre>
 
{
 
{
 
     "subscribe": 1,  
 
     "subscribe": 1,  
−
     "openid": "o6_bmjrPTlm6_2sgVt7hMZOPfL2M",  
+
     "uid": "123123123",  
−
     "nickname": "Band",  
+
     "nickname": "punk",  
 
     "sex": 1,  
 
     "sex": 1,  
 
     "language": "zh_CN",  
 
     "language": "zh_CN",  
第44行： 第43行：
 
     "province": "广东",  
 
     "province": "广东",  
 
     "country": "中国",  
 
     "country": "中国",  
−
     "headimgurl":    "http://wx.qlogo.cn/mmopen/g3MonUZtNHkdmzicIlibx6iaFqAc56vxLSUfpb6n5WKSYVY0ChQKkiaJSgQ1dZuTOgvLLrhJbERQQ4eMsv84eavHiaiceqxibJxCfHe/0",  
+
     "headimgurl":    "xxx",  
−
  "subscribe_time": 1382694957
+
     "headimgurl_large":   "xxx",  
−
}
+
     "headimgurl_hd":   "xxx",  
−
 
+
     "follow":   "1",  
−
{
+
     "subscribe_time": 1382694957
−
     "id": 1404376560,
+
−
    "screen_name": "zaku",
+
−
     "name": "zaku",
+
−
     "province": "11",
+
−
    "city": "5",
+
−
    "location": "北京 朝阳区",
+
−
    "description": "人生五十年，乃如梦如幻；有生斯有死，壮士复何憾。",
+
−
    "url": "http://blog.sina.com.cn/zaku",
+
−
    "profile_image_url": "http://tp1.sinaimg.cn/1404376560/50/0/1",
+
−
     "domain": "zaku",
+
−
    "gender": "m",
+
−
    "followers_count": 1204,
+
−
    "friends_count": 447,
+
−
    "statuses_count": 2908,
+
−
    "favourites_count": 0,
+
−
    "created_at": "Fri Aug 28 00:00:00 +0800 2009",
+
−
    "following": false,
+
−
    "allow_all_act_msg": false,
+
−
    "geo_enabled": true,
+
−
    "verified": false,
+
−
    "status": {
+
−
        "created_at": "Tue May 24 18:04:53 +0800 2011",
+
−
        "id": 11142488790,
+
−
        "text": "我的相机到了。",
+
−
        "source": "<a href="http://weibo.com" rel="nofollow">新浪微博</a>",
+
−
        "favorited": false,
+
−
        "truncated": false,
+
−
        "in_reply_to_status_id": "",
+
−
        "in_reply_to_user_id": "",
+
−
        "in_reply_to_screen_name": "",
+
−
        "geo": null,
+
−
        "mid": "5610221544300749636",
+
−
        "annotations": [],
+
−
        "reposts_count": 5,
+
−
        "comments_count": 8
+
−
    },
+
−
    "allow_all_comment": true,
+
−
    "avatar_large": "http://tp1.sinaimg.cn/1404376560/180/0/1",
+
−
    "verified_reason": "",
+
−
    "follow_me": false,
+
−
    "online_status": 0,
+
−
    "bi_followers_count": 215
+
 
}
 
}
 +
</pre>
  
 +
参数说明：
 
{| border="1" cellspacing="0" cellpadding="0" width="100%" class="parameters" style="border-color: #CCCCCC;"
 
{| border="1" cellspacing="0" cellpadding="0" width="100%" class="parameters" style="border-color: #CCCCCC;"
 
|-
 
|-
第98行： 第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|int|用户所在城市ID}}
+
{{rdes_args|city|string|用户所在城市}}
−
country?
+
{{rdes_args|country|string|用户所在国家}}
−
{{rdes_args|province|int|用户所在省级ID}}
+
{{rdes_args|province|int|用户所在省份}}
−
{{rdes_args|location|string|用户所在地}}
+
{{rdes_args|language|string|用户当前的语言版本，zh_CN 简体，zh_TW 繁体，en英语}}
−
{{rdes_args|language|string|用户当前的语言版本，zh-cn：简体中文，zh-tw：繁体中文，en：英语}}
+
 
{{rdes_args|headimgurl|string|用户头像地址（中图），50×50像素}}
 
{{rdes_args|headimgurl|string|用户头像地址（中图），50×50像素}}
−
{{rdes_args|name|string|友好显示名称}}
+
{{rdes_args|headimgurl_large|string|用户头像地址（大图），180×180像素}}
−
{{rdes_args|subscribe|boolean|是否订阅}}
+
{{rdes_args|headimgurl_hd|string|用户头像地址（高清），高清头像原图}}
−
{{rdes_args|follow_me|boolean|该用户是否关注当前登录用户，true：是，false：否}}
+
 
{{rdes_args|subscribe_time|string|订阅时间}}
 
{{rdes_args|subscribe_time|string|订阅时间}}
 +
{{rdes_args|follow|int|该用户是否关注access_token中的uid，1：是，0：否}}
 
|}
 
|}
 +
 +
如果请求参数uid不是access_token中uid的粉丝，则返回：
 
<pre>
 
<pre>
−
// 成功返回
+
{  
−
{
+
     "follow":   "0" //不同于微信subscribe=0就无法拉取其余信息，微博只有当follow=0时，也就是用户没有关注该账号时，才无法拉取其余信息；
−
     "ticket": "XXX",
+
−
    "expire_seconds": 1800
+
 
}
 
}
 +
</pre>
 +
  
 
// 失败返回
 
// 失败返回
 +
<pre>
 
{
 
{
−
     "request": "/2/eps/qrcode/create.json",
+
     "request": "/2/eps/user/info.json",
 
     "error_code": 284XX,
 
     "error_code": 284XX,
 
     "error": "error message."
 
     "error": "error message."

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."
}



来自“http://open.weibo.com/wiki/index.php?title=%E8%8E%B7%E5%8F%96%E7%94%A8%E6%88%B7%E5%9F%BA%E6%9C%AC%E4%BF%A1%E6%81%AF&oldid=12966”
文档更新时间: 2014-05-04

关于微博开放平台| 联系我们| 服务条款| 无线游戏| 开放平台官微

京网文 [2011] 0398-130号 京ICP证100780号 Copyright © 1996-2024 SINA