2010年9月13日 (一) 17:37的版本

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