返回顶部

get_fanslist

1 接口说明

获取登录用户的听众列表。

 

1.1 URL

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

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:新模式,可以拉取所有听众的信息,暂时不支持排序。

install string 判断获取的是安装应用的听众,还是未安装应用的听众。 

0:不考虑该参数;

1:获取已安装应用的听众信息;

2:获取未安装应用的听众信息。

sex string 按性别过滤标识,默认为0。此参数当mode=0时使用,支持排序。 

1:获取的是男性听众信息;

2:获取的是女性听众信息;

0:不进行性别过滤,获取所有听众信息。

1.5 请求示例

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

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

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

oauth_consumer_key=123456&

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

format=xml&

reqnum=30&

startindex=0&

mode=1

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 收听的人数。
isidol 是否为用户收听的人(0:不是; 1:是)。
isvip 听众是否为微博认证用户(0:不是; 1:是)。
tag 听众标签。
id 标签ID。
name 标签名。

1.7 正确返回示例

1.8 错误返回示例