分享到 :

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>
返回顶部