分享到 :

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

1.8 错误返回示例

返回顶部