分享到 :

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

<?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>aaaa</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>
          <isfans>1</isfans>
          <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>
返回顶部