get_repost_list

目录

1 接口说明

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


1.1 URL

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

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

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" ?> 
<root>
   <data>
       <ret>4</ret> 
       <errcode>5</errcode>
       <msg>禁止访问,城市,QQ号码被加入黑名单</msg>
   </data>
</root>

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

Copyright © 1998 - 2019 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部