Statuses/repost

跳转到: 导航, 搜索

目录

statuses/repost

转发一条微博信息。请求必须用POST方式提交。为防止重复,发布的信息与最新信息一样话,将会被忽略。

URL

http://api.t.sina.com.cn/statuses/repost.format

或者

http://api.t.sina.com.cn/statuses/retweet/id.format

格式

xml, json

HTTP请求方式

POST

是否需要登录

true

请求数限制

true

关于请求数限制,参见接口访问权限说明

请求参数

  • id 必填参数, 转发的微博ID
  • status. 可选参数, 添加的转发信息。必须做URLEncode,信息内容不超过140个汉字。如不填则自动生成类似“转发 @author: 原内容”文字。

使用说明

  • 如果没有登录,将返回403错误
  • 转发的微博不存在,将返回500错误
  • 微博将忽略重复的发布。每次发布将比较登录用户的最新一条发布消息,如果一样将被忽略。因此,用户不能连续提交相同信息。 发布成功返回发布的信息ID,否则返回为空。

返回结果

XML示例

<?xml version="1.0" encoding="UTF-8"?>
<status>
  <created_at>Mon Sep 13 17:32:04 +0800 2010</created_at>
  <id>2590627684</id>
  <text>转发微博</text>
  <source>
    <a href="http://open.t.sina.com.cn">微博开放平台接口</a>
  </source>
  <favorited>false</favorited>
  <truncated>false</truncated>
  <geo/>
  <in_reply_to_status_id>2265657555</in_reply_to_status_id>
  <in_reply_to_user_id>1763124584</in_reply_to_user_id>
  <in_reply_to_screen_name>标-心</in_reply_to_screen_name>
  <user>
    <id>1642466141</id>
    <screen_name>huchao</screen_name>
    <name>huchao</name>
    <province>11</province>
    <city>8</city>
    <location>北京 海淀区</location>
    <description>Blogger,苹果迷,Google粉。</description>
    <url>http://tuoniao.org</url>
    <profile_image_url>http://tp2.sinaimg.cn/1642466141/50/1281523744</profile_image_url>
    <domain>westy</domain>
    <gender>m</gender>
    <followers_count>60</followers_count>
    <friends_count>59</friends_count>
    <statuses_count>137</statuses_count>
    <favourites_count>1</favourites_count>
    <created_at>Fri Aug 28 00:00:00 +0800 2009</created_at>
    <following>false</following>
    <verified>false</verified>
    <allow_all_act_msg>false</allow_all_act_msg>
    <geo_enabled>false</geo_enabled>
  </user>
  <retweeted_status>
    <created_at>Fri Sep 03 11:41:08 +0800 2010</created_at>
    <id>2265657555</id>
    <text>今日下午回初中看看,然后老同学请吃饭,因为距明天就去报到了,最后的晚餐。希望老天留翻D眼泪等到我军训时先留。。</text>
    <source>
      <a href="http://t.sina.com.cn">新浪微博</a>
    </source>
    <favorited>false</favorited>
    <truncated>false</truncated>
    <geo/>
    <in_reply_to_status_id/>
    <in_reply_to_user_id/>
    <in_reply_to_screen_name/>
    <user>
      <id>1763124584</id>
      <screen_name>标-心</screen_name>
      <name>标-心</name>
      <province>44</province>
      <city>1</city>
      <location>广东 广州</location>
      <description>不帅也不C</description>
      <url>http://blog.163.com/chen_mou/</url>
      <profile_image_url>http://tp1.sinaimg.cn/1763124584/50/1283605697</profile_image_url>
      <domain/>
      <gender>m</gender>
      <followers_count>17</followers_count>
      <friends_count>16</friends_count>
      <statuses_count>71</statuses_count>
      <favourites_count>0</favourites_count>
      <created_at>Thu Jun 17 00:00:00 +0800 2010</created_at>
      <following>false</following>
      <verified>false</verified>
      <allow_all_act_msg>false</allow_all_act_msg>
      <geo_enabled>false</geo_enabled>
    </user>
  </retweeted_status>
</status>

JSON示例

    {"created_at":"Thu Jan 07 10:07:45 +0800 2010",
    "id":142284,
    "text":"111111111111111111",
    "source":"<a id=\"0\" href=\"http://t.sina.com.cn/\" rel=\"nofollow\">Web</a>",
    "favorited":false,
    "truncated":false,
    "in_reply_to_status_id":"142281",
    "in_reply_to_user_id":"11046",
    "in_reply_to_screen_name":"name_11046",
    "geo":null,
    "user":<br/>        {"id":11075,
         "screen_name":"name_11075",
         "name":"name_11075",
         "province":"0",
         "city":"0",
         "location":"",
         "description":"",
         "url":"",
         "profile_image_url":"http://tp4.sinaimg.cn/11075/50/0",
         "domain":"11075",
         "followers_count":28,
         "friends_count":50,
         "statuses_count":0,
         "favourites_count":27,
         "created_at":"Thu Jan 01 08:00:00 +0800 1970",
         "following":false,
         "geo_enabled":false,
         "verified":true},
    "retweeted_status":<br/>        {"created_at":"Thu Jan 07 09:54:49 +0800 2010",
         "id":142281,
         "text":"测试test",
         "source":"<a id=\"0\" href=\"http://t.sina.com.cn/\" rel=\"nofollow\">Web</a>",
         "favorited":false,
         "truncated":false,
         "in_reply_to_status_id":"",
         "in_reply_to_user_id":"",
         "in_reply_to_screen_name":"",
         "geo":null,
         "user":<br/>            {"id":11046,
              "screen_name":"name_11046",
              "name":"name_11046",
              "province":"0",
              "city":"0",
              "location":"",
              "description":"",
              "url":"",
              "profile_image_url":"http://tp3.sinaimg.cn/11046/50/0",
              "domain":"11046",
              "followers_count":37,
              "friends_count":50,
              "statuses_count":0,
              "favourites_count":0,
              "created_at":"Thu Jan 01 08:00:00 +0800 1970",
              "following":false,
              "geo_enabled":false,
              "verified":false}
         }
    }

字段说明 - status

  • created_at: 创建时间
  • id: 微博ID
  • text: 微博信息内容
  • source: 微博来源
  • favorited: 是否已收藏
  • truncated: 是否被截断
  • in_reply_to_status_id: 回复ID
  • in_reply_to_user_id: 回复人UID
  • in_reply_to_screen_name: 回复人昵称
  • thumbnail_pic: 缩略图
  • bmiddle_pic: 中型图片
  • original_pic:原始图片
  • user: 作者信息
  • retweeted_status: 转发的博文,内容为status,如果不是转发,则没有此字段

字段说明 - user

  • id: 用户UID
  • screen_name: 微博昵称
  • name: 友好显示名称,同微博昵称
  • province: 省份编码(参考省份编码表)
  • city: 城市编码(参考城市编码表)
  • location:地址
  • description: 个人描述
  • url: 用户博客地址
  • profile_image_url: 自定义图像
  • domain: 用户个性化URL
  • gender: 性别,m--男,f--女,n--未知
  • followers_count: 粉丝数
  • friends_count: 关注数
  • statuses_count: 微博数
  • favourites_count: 收藏数
  • created_at: 创建时间
  • following: 是否已关注(此特性暂不支持)
  • verified: 加V标示,是否微博认证用户

使用示例

  • xml:

curl -u uid:password -d "source=appkey&id=1&status=playing with cURL and repost" http://api.t.sina.com.cn/statuses/repost.xml

  • json:

curl -u uid:password -d "source=appkey&id=1&status=playing with cURL and repost" http://api.t.sina.com.cn/statuses/repost.json

PHP示例

请从 微博SDK开发包下载 处下载PHP SDK(支持OAuth验证之版本)
代码示例如下:

//Statuses/repost
$c = new WeiboClient( WB_AKEY , 
                      WB_SKEY , 
                      $_SESSION['last_key']['oauth_token'] , 
                      $_SESSION['last_key']['oauth_token_secret']  );
$msg = $c->user_timeline();
if ($msg === false || $msg === null){
	echo "Error occured";
	return false;
} 
if (count($msg)> 1){
	$sid = $msg[1]['id'];
	echo($sid);
	$msg  = $c->repost($sid);
	if ($msg === false || $msg === null){
		echo "Error occured";
		return false;
	}
	echo($msg['id'].' : '.$msg['text']);
}