Statuses/repost
(→返回结果) |
(→返回结果) |
||
第151行: | 第151行: | ||
} | } | ||
</pre> | </pre> | ||
+ | {{Param_status}} | ||
+ | {{Param_user}} | ||
=== 使用示例=== | === 使用示例=== |
2010年9月2日 (四) 13:50的版本
目录 |
statuses/repost
转发一条微博信息。请求必须用POST方式提交。为防止重复,发布的信息与最新信息一样话,将会被忽略。
URL
http://api.t.sina.com.cn/statuses/repost.format or 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>Tue Dec 01 08:51:58 +0800 2009</created_at> <id>99999999</id> <text>转发:@1141457724 </text> <source> <a href="http://t.sina.com.cn">Web</a> </source> <favorited>false</favorited> <truncated>false</truncated> <in_reply_to_status_id></in_reply_to_status_id> <in_reply_to_user_id></in_reply_to_user_id> <in_reply_to_screen_name></in_reply_to_screen_name> <user> <id>1141457724</id> <screen_name>1141457724</screen_name> <name>1141457724</name> <location>广州</location> <description>blog: timyang.net</description> <url>http://timyang.net</url> <profile_image_url>http://portrait.sinaimg.cn/1141457724/50#.jpg</profile_image_url> <followers_count>0</followers_count> <friends_count>0</friends_count> <statuses_count>0</statuses_count> <favourites_count>0</favourites_count> <following>false</following> </user> <retweeted_status> <created_at>Tue Dec 01 08:51:58 +0800 2009</created_at> <id>100000000</id> <text>虽然渴者只要少许的水便够了,我却很快活地给与了我全部的水。</text> <source> <a href="http://t.sina.com.cn">Web</a> </source> <favorited>false</favorited> <truncated>false</truncated> <in_reply_to_status_id></in_reply_to_status_id> <in_reply_to_user_id></in_reply_to_user_id> <in_reply_to_screen_name></in_reply_to_screen_name> <thumbnail_pic>http://static16.photo.sina.com.cn/thumbnail/62988d06tcbbc377f7bbf</thumbnail_pic> <bmiddle_pic>http://static16.photo.sina.com.cn/bmiddle/62988d06tcbbc377f7bbf</bmiddle_pic> <original_pic>http://static16.photo.sina.com.cn/orignal/62988d06tcbbc377f7bbf</original_pic> <user> <id>1337040644</id> <screen_name>1337040644</screen_name> <name>1337040644</name> <location>广州</location> <description>blog: timyang.net</description> <url>http://timyang.net</url> <profile_image_url>http://portrait.sinaimg.cn/1337040644/50#.jpg</profile_image_url> <followers_count>0</followers_count> <friends_count>0</friends_count> <statuses_count>0</statuses_count> <favourites_count>0</favourites_count> <following>false</following> </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']); }