get_info

1 接口说明

获取腾讯微博登录用户的用户资料。
 

1.1 URL

OAuth2.0协议： https://graph.qq.com/user/get_info

1.2 格式

JSON，XML

1.3 HTTP请求方式

GET

1.4 输入参数说明

各个参数请进行URL 编码，编码时请遵守 RFC 1738
（1）通用参数
-OAuth2.0协议必须传入的通用参数，详见这里。
（2）私有参数

参数名称是否必须类型描述
formatstring定义API返回的数据格式。
取值说明：为xml时表示返回的格式是xml；为json时表示返回的格式是json。 
注意：json、xml为小写，否则将不识别。format不传或非xml，则返回json格式数据。

1.5 请求示例

以OAuth2.0协议为例（敏感信息都用*号进行了处理，实际请求中需要替换成真实的值）：

https://graph.qq.com/user/get_info?
access_token=*************&
oauth_consumer_key=123456&
openid=****************&
format=xml

1.6 返回参数说明

参数名称描述
ret返回码。
-公共返回码说明详见：公共返回码说明。
-微博OpenAPI私有返回码详见：微博私有返回码说明。
-本接口私有返回码说明详见：这里。
errcode二级错误码，详见：微博私有返回码说明。
msg如果ret不为0，会有相应的错误信息提示，返回数据全部用UTF-8编码。
data登录用户的详细信息列表。
birth_year登录用户出生年。
birth_month登录用户出生月份。
birth_day登录用户出生日。
city_code登录用户所在的城市代码。
城市名称与代码的对应关系请参见国家城市名称对应代码列表。
comp登录用户的工作所在公司信息列表。
begin_year开始年。
company_name公司名称。
department_name部门名称。
end_year结束年。
id公司id。
country_code登录用户所在的国家代码。
国家名称与代码的对应关系请参见国家城市名称对应代码列表。
edu登录用户教育信息列表。
id教育信息记录ID。
year入学年。
schoolid学校ID。
学校ID与学校具体信息的对应关系请参见教育信息数据库。
departmentid院系ID。
院系ID与院系具体信息的对应关系请参见教育信息数据库。
level学历级别。
fansnum登录用户听众数。
favnum登录用户收藏数。
head登录用户头像url。
头像有如下3种不同的尺寸：100px，50px，30px，这里获取的头像url中没有尺寸，如下所示：
http://app.qlogo.cn/mbloghead/563ad8b6be488a07a694
开发者需要在url后增加尺寸数字，才能获取到对应尺寸的头像，例如想获取30px的头像，url后增加数字30，如下所示：
http://app.qlogo.cn/mbloghead/563ad8b6be488a07a694/30
homecountry_code登录用户家乡所在国家代码。
国家名称与代码的对应关系请参见国家城市名称对应代码列表。
homeprovince_code登录用户家乡所在省份代码。
国家名称与代码的对应关系请参见国家城市名称对应代码列表。
homecity_code登录用户家乡所在城市代码。
国家名称与代码的对应关系请参见国家城市名称对应代码列表。
hometown_code登录用户家乡所在城镇代码。
国家名称与代码的对应关系请参见国家城市名称对应代码列表。
homepage个人主页。
idolnum登录用户收听的人数。
industry_code行业ID。
introduction登录用户的个人介绍。
isent登录用户是否为企业机构（0：不是； 1：是）。
ismyblack是否在当前用户的黑名单中（0：不是； 1：是）。
ismyfans是否是当前用户的听众（0：不是； 1：是）。
ismyidol是否是当前用户的偶像（0：不是； 1：是）。
isrealname登录用户是否实名认证（0：未实名认证；1：已实名认证）。
isvip登录用户是否为微博认证用户（0：不是； 1：是）。
location登录用户所在地。
mutual_fans_num登录用户的互听好友数。
name登录用户的帐号名。
openid登录用户的唯一ID，与name一一对应。
nick登录用户昵称。
province_code登录用户所在的省代码。
省份名称与代码的对应关系请参见国家城市名称对应代码列表。
regtime登录注册时间。
send_private_flag是否允许所有人给当前用户发私信。
0：仅有偶像；
1：名人+听众；
2：所有人。
sex登录用户性别（1：男； 2：女； 0：未填写）。
tag标签信息列表。
id个人标签id。
name标签名。
tweetinfo最近的一条原创微博信息。
city_code发表微博时所作的城市代码。
country_code发表微博时所作的国家代码。
emotiontype心情类型。
emotionurl心情图片url。
from来源。
fromurl来源url。
geo地理位置信息。
id微博唯一id。
image图片url。
latitude纬度。
location发表者所在地。
longitude经度。
music音频信息。
author演唱者。
url音频地址。
title音频名字，歌名。
origtext微博原始内容。
province_code发表微博时所作的省份代码。
self是否自已发的的微博（0：不是； 1：是）。
status表示微博的状态。
0：正常；
1：微博被系统删除；
2：审核中；
3；微博被用户删除；
4：源微博被系统审核删除。
text微博内容。
timestamp服务器时间戳，不能用于翻页。
type表示微博的类型。
1：原创发表；
2：转播；
3：私信；
4：回复；
5：没有内容的回复；
6：提及；
7：评论。
video视频信息。
picurl缩略图。
player播放器地址。
realurl视频原地址。
shorturl视频的短url。
title视频标题。
tweetnum登录用户发表的微博数。
verifyinfo认证信息。
exp经验值。
level微博等级。
seqid序列号。

1.7 正确返回示例

Content-type: text/html; charset=utf-8
{
   "errcode":0,
   "msg":"ok",
   "ret": 0,
   "data":
   {
     "birth_day":8,
     "birth_month":8,
     "birth_year":1987,
     "city_code":"1",
     "comp":null,
     "country_code":"1",
     "edu":[
     {
             "departmentid":5319,
             "id":24037,
             "level":4,
             "schoolid":10428,
             "year":2007
     }],
     "exp":730,
     "fansnum":64,
     "favnum":0,
     "head":"http://app.qlogo.cn/mbloghead/12a36d51c6ee9f967732",
     "homecity_code":"",
     "homecountry_code":"",
     "homepage":"",
     "homeprovince_code":"",
     "hometown_code":"",
     "idolnum":84,
     "industry_code":0,
     "introduction":"",
     "isent":0,
     "ismyblack":0,
     "ismyfans":0,
     "ismyidol":0,
     "isrealname":1,
     "isvip":0,
     "level":2,
     "location":"中国 湖北 武汉",
     "mutual_fans_num":26,
     "name":"peter",
     "nick":"tom",
     "openid":"813B5DD59D54FE52FAC72AC1BF28EE82",
     "province_code":"42",
     "regtime":1299585734,
     "send_private_flag":0,
     "sex":1,
     "tag":[
      {
             "id":"3274154839212534452",
             "name":"微博控",
      }],
     "tweetinfo":[
      {
             "city_code":"",
             "country_code":"",
             "emotiontype":0,
             "emotionurl":"",
             "from":"腾讯互联",
             "fromurl":"http://qzone.qq.com//u000a",
             "geo":"",
             "id":"50451010397633",
             "image":null,
             "latitude":"0",
             "location":"未知",
             "longitude":"0",
             "music":null,
             "origtext":"爱护环境，人人有责",
             "province_code":"",
             "self":1,
             "status":0,
             "text":"爱护环境，人人有责",
             "timestamp":1345799002,
             "type":1,
             "video":null
       }],
     "tweetnum":66,
     "verifyinfo":""
     },
   "seqid":5782353821101409088
}

1.8 错误返回示例

Content-type: text/html; charset=utf-8
{
"ret":1002,
"msg":"请先登录"
}