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
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":"请先登录" }