分享到 :

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 正确返回示例

<?xml version="1.0" encoding="UTF-8"?>
<data>
  <ret>0</ret>
  <errcode>0</errcode>
  <msg>ok</msg>
  <data>
     <timestamp>128679200</timestamp>
     <hasnext>0</hasnext>
     <info>
          <name></name>
          <openid>B624064BA065E01CB73F835017FE96FA</openid>
          <nick>abcd</nick>
          <head>http://app.qlogo.cn/mbloghead/563ad8b6be488a07a694</head>
          <sex>1</sex>
          <location>广东 深圳</location>
          <country_code>1</country_code>
          <province_code>44</province_code>
          <city_code>3</city_code>
          <tweet>
               <text></text>
               <from>来自网页</from>
               <id>7987543214334</id>
               <timestamp>1285813236</timestamp>
          </tweet>
          <fansnum>15</fansnum>
          <idolnum>20</idolnum>
          <isidol>0</isidol>
          <isvip>0</isvip>
          <tag>
               <id>1</id>
               <name></name>
          </tag>
     </info>
     ............
  </data>
</data>

1.8 错误返回示例

<?xml version="1.0" encoding="UTF-8" ?>
<root>
   <data>
       <ret>1002</ret>
       <msg><![CDATA[请先登录]]></msg>
   </data>
</root>


 

返回顶部