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']); }