分享到 :

get_repost_list

1 接口说明

获取一条微博的转播或评论信息列表。
 

1.1 URL

OAuth2.0协议： https://graph.qq.com/t/get_repost_list

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格式数据。
flag 必须 string 标识获取的是转播列表还是点评列表。 
0：获取转播列表；
1：获取点评列表；
2：转播列表和点评列表都获取。
rootid 必须 string 转发或点评的源微博的ID。
pageflag 必须 string 分页标识。 
0：第一页；
1：向下翻页；
2：向上翻页。
pagetime 必须 string 本页起始时间。 
第一页：0；
向下翻页：上一次请求返回的最后一条记录时间；
向上翻页：上一次请求返回的第一条记录的时间。
reqnum 必须 string 每次请求记录的条数。取值为1-100条。
twitterid 必须 string 翻页时使用。 
第1-100条：0；
继续向下翻页：上一次请求返回的最后一条记录id。

1.5 请求示例

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

https://graph.qq.com/t/get_repost_list?
access_token=*************&
oauth_consumer_key=123456&
openid=****************&
format=xml&
flag=0&
rootid=123456789&
pageflag=0&
pagetime=0&
reqnum=20&
twitterid=0

1.6 返回参数说明

参数名称 描述
ret 返回码。 
-公共返回码说明详见：公共返回码说明。
-微博OpenAPI私有返回码详见：微博私有返回码说明。
-本接口私有返回码说明详见：这里。
errcode 二级错误码，详见：微博私有返回码说明。
msg 如果ret不为0，会有相应的错误信息提示，返回数据全部用UTF-8编码。
data 转播或评论的信息列表。
timestamp 服务器时间戳。
hasnext 表示是否还有微博可以拉取。 
0：还有微博可以拉取。
1：已拉取完。
info 微博的详细信息列表。
text 获取的微博的内容。
origtext 获取源微博的内容。
count 转播次数。
mcount 评论数。
from 微博来源。
id 微博的ID，用来唯一标识一条微博。
image 微博中的图片url。
name 发表或转播微博的用户名称。
openid 发表或转播微博的用户QQ号码对应的ID。
nick 用户昵称。
self 是否为自己发表的微博（0：不是； 1：是）。
timestamp 发表或转播微博的时间。
type 表示微博的类型。 
1：原创发表；
2：转播;
3：私信；
4：回复；
5：没有内容的回复；
6：提及；
7：评论。
head 用户的头像url。 
头像有如下3种不同的尺寸：100px，50px，30px，这里获取的头像url中没有尺寸，如下所示：
http://app.qlogo.cn/mbloghead/563ad8b6be488a07a694
开发者需要在url后增加尺寸数字，才能获取到对应尺寸的头像，例如想获取30px的头像，url后增加数字30，如下所示：
http://app.qlogo.cn/mbloghead/563ad8b6be488a07a694/30
location 用户所在的省市。
country_code 用户所在的国家代码。 
国家名称与代码的对应关系请参见国家城市名称对应代码列表。
province_code 用户所在的省代码。 
省份名称与代码的对应关系请参见国家城市名称对应代码列表。
city_code 用户所在的城市代码。 
城市名称与代码的对应关系请参见国家城市名称对应代码列表。
isvip 用户是否为微博认证用户（0：不是； 1：是）。
geo 用户地理信息。
user 用户信息列表。
name:nick 当页数据涉及到的用户的帐号与昵称映射。

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>
     <totalnum>2</totalnum>
     <info>
          <text></text>
          <origtext></origtext>
          <count>2</count>
          <from>来自网页</from>
          <id>7987543214334</id>
          <image></image>
          <name>abc</name>
          <openid>B624064BA065E01CB73F835017FE96FA</openid>
          <nick>abcd</nick>
          <self>0</self>
          <timestamp>1285813236</timestamp>
          <type>1</type>
          <head>http://app.qlogo.cn/mbloghead/563ad8b6be488a07a694</head>
          <location>广东 深圳</location>
          <country_code>1</country_code>
          <province_code>44</province_code>
          <city_code>3</city_code>
          <isvip>0</isvip>
          <geo>null</geo>
     </info>
     ............
  </data>
  <user>
     <name:nick></name:nick>
     ............
  </user>
</data>

1.8 错误返回示例

<?xml version="1.0" encoding="UTF-8"&nbsp;?>
<root>
   <data>
       <ret>4</ret>
       <errcode>5</errcode>
       <msg>禁止访问，城市，QQ号码被加入黑名单</msg>
   </data>
</root>
返回顶部