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