分享到 :

get_idollist

1 接口说明

获取登录用户收听的人的列表。

1.1 URL

OAuth2.0协议: https://graph.qq.com/relation/get_idollist

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格式数据。

reqnum 必须 string 请求获取的收听个数。取值范围为1-30。
startindex 必须 string 请求获取收听列表的起始位置。 

第一页:0;

继续向下翻页:reqnum*(page-1)。

mode string 获取收听的人的信息模式,默认为0。 

0:旧模式,新添加的收听的人信息排在前面,最多只能拉取1000个收听的人的信息。

1:新模式,最多可拉取10000个收听的人的信息,暂不支持排序。

install string 判断获取的是安装了应用的收听好友,还是未安装应用的收听好友。 

0:不考虑该参数;

1:获取已安装应用的收听好友信息;

2:获取未安装应用的收听好友信息。

1.5 请求示例

以OAuth2.0协议为例(敏感信息都用*号进行了处理,实际请求中需要替换成真实的值):

https://graph.qq.com/relation/get_idollist?

access_token=*************&

oauth_consumer_key=123456&

openid=****************&

format=xml&

reqnum=30&

startindex=0

1.6 返回参数说明

参数名称 描述
ret 返回码。 

-公共返回码说明详见:公共返回码说明

-微博OpenAPI私有返回码详见:微博私有返回码说明

errcode 二级错误码,详见:微博私有返回码说明
msg 如果ret不为0,会有相应的错误信息提示,返回数据全部用UTF-8编码。
data 收听的列表信息。
timestamp 服务器时间戳。
hasnext 表示是否还有收听信息可以拉取。 

0:还有收听信息可以拉取。

1:已拉取完。

info 收听的详细信息列表。
name 收听的人的账户名。
openid 收听的人的唯一ID,与QQ号码一一对应。
nick 收听的人的昵称。
head 收听的人的头像url。 

头像有如下3种不同的尺寸:100px,50px,30px,这里获取的头像url中没有尺寸,如下所示:

http://app.qlogo.cn/mbloghead/563ad8b6be488a07a694

开发者需要在url后增加尺寸数字,才能获取到对应尺寸的头像,例如想获取30px的头像,url后增加数字30,如下所示:

http://app.qlogo.cn/mbloghead/563ad8b6be488a07a694/30

sex 收听的人的性别(0:表示未填写; 1:男; 2:女)。
location 收听的人发表微博时的所在地。
country_code 用户所在国家的代码。 

国家名称与代码的对应关系请参见国家城市名称对应代码列表

province_code 用户所在省的代码。 

省份名称与代码的对应关系请参见国家城市名称对应代码列表

city_code 用户所在城市的代码。 

城市名称与代码的对应关系请参见国家城市名称对应代码列表

tweet 收听的人最近发表的一条微博。
text 微博的内容。
from 微博的来源。
id 微博ID,用来唯一标识一条微博。
timestamp 发表微博的时间。
fansnum 听众数。
idolnum 收听的人数。
isfans 是否为用户的听众(0:不是; 1:是)。
isvip 收听的人是否为微博认证用户(0:不是; 1:是)。
tag 收听标签。
id 标签ID。
name 标签名。

1.7 正确返回示例

1.8 错误返回示例

返回顶部