get_idollist

目录

1 接口说明

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


1.1 URL

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 请求示例

(敏感信息都用*号进行了处理,实际请求中需要替换成真实的值):

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>

以上信息是否解决您的问题?

Copyright © 1998 - 2019 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部