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