get_other_info
1 接口说明
获取腾讯微博其他用户详细信息。
1.1 URL
OAuth2.0协议: https://graph.qq.com/user/get_other_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格式数据。 |
|
name | string | 其他用户的账户名。 可选,name和fopenid至少选一个,若同时存在则以name值为主。 |
|
fopenid | string | 其他用户的openid。 可选,name和fopenid至少选一个,若同时存在则以name值为主。 |
1.5 请求示例
以OAuth2.0协议为例(敏感信息都用*号进行了处理,实际请求中需要替换成真实的值):
https://graph.qq.com/user/get_other_info?
access_token=*************&
oauth_consumer_key=123456&
openid=****************&
format=xml&
name=peter
access_token=*************&
oauth_consumer_key=123456&
openid=****************&
format=xml&
name=peter
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": 12, "birth_month": 4, "birth_year": 1980, "city_code": "3", "comp": [ { "begin_year": 2011, "company_name": "XX有限公司", "department_name": "", "end_year": 9999, "id": 20000 } ], "country_code": "1", "edu": [ { "departmentid": 0, "id": 24038, "level": 0, "schoolid": 0, "year": 2000 }, { "departmentid": 16, "id": 24037, "level": 4, "schoolid": 11360, "year": 2004 }, { "departmentid": 11, "id": 24039, "level": 2, "schoolid": 11, "year": 2008 } ], "fansnum": 170, "favnum": 0, "head": "http://app.qlogo.cn/mbloghead/c85c54302e2ef933587a", "homecity_code": "1", "homecountry_code": "1", "homepage": "http://hi.abc.com/123456", "homeprovince_code": "22", "hometown_code": "", "idolnum": 179, "industry_code": 2002, "introduction": "快乐,其实很简单", "isent": 0, "ismyblack": 0, "ismyfans": 0, "ismyidol": 0, "isrealname": 0, "isvip": 0, "location": "中国 广东 深圳", "mutual_fans_num": 125, "name": "aaa", "nick": "tom", "openid": "00000000000000000000000016E8FF2FFC", "province_code": "44", "regtime": 1281104833, "send_private_flag": 0, "sex": 2, "tag": [ { "id": "77846971042806542", "name": "旅游" }, { "id": "464633551361363735", "name": "动漫" }, { "id": "8883392011515948172", "name": "IT民工" }, { "id": "13657878042428889146", "name": "乐活族" } ], "tweetinfo": [ { "city_code": "3", "country_code": "1", "emotiontype": 0, "emotionurl": "", "from": "腾讯微博", "fromurl": "http://t.qq.comn", "geo": "", "id": "131008025107394", "image": null, "latitude": "0", "location": "中国 广东 深圳", "longitude": "0", "music": null, "origtext": "开心", "province_code": "44", "self": 1, "status": 0, "text": "开心", "timestamp": 1337765791, "type": 1, "video": null } ], "tweetnum": 802, "verifyinfo": "", "exp": 1, "level": 1 }, "seqid": 5782353821101409088
}
1.8 错误返回示例
Content-type: text/html; charset=utf-8 { "ret":1002, "msg":"请先登录" }