分享到 :

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)私有参数

参数名称 是否必须 类型 描述
format string 定义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":"请先登录"
}
返回顶部