Statuses/update
目录 |
statuses/update
发布一条微博信息。请求必须用POST方式提交。为防止重复,发布的信息与当前最新信息一样话,将会被忽略。
URL
http://api.t.sina.com.cn/statuses/update.format
格式
xml, json, rss, atom
HTTP请求方式
POST
是否需要身份验证
true
请求数限制
false
请求参数
- status. 必填参数, 要更新的微博信息。必须做URLEncode,信息内容部超过140个汉字。
- in_reply_to_status_id. 可选参数,@ 需要回复的微博ID, 这个参数只有在微博内容以 @username 开头才有意义。
- lat. 可选参数,纬度,发表当前微博所在的地理位置,有效范围 -90.0到+90.0, +表示北纬。只有用户设置中geo_enabled=true时候地理位置才有效。(保留字段,暂不支持)
- long. 可选参数,经度。有效范围-180.0到+180.0, +表示东经。
使用说明
- 如果没有登录或超过发布上限,将返回403错误
- 系统将忽略重复发布的信息。每次发布将比较最后一条发布消息,如果一样将被忽略。因此用户不能连续提交相同信息。发布成功返回发布的信息ID,否则返回为空。
返回
XML示例:
<?xml version="1.0" encoding="UTF-8"?>
<status> <created_at>Tue Dec 15 13:05:11 +0800 2009</created_at> <id>2</id> <text>有一年休年假的时候忘了请假,晚回来2天,结果老板大发雷霆,问我到底还干不干,正好我朋友发信息问我是在家找工作还是继续干下去,于是我回答说先干着吧,反正家里工作也不好找,结果手一抖,发给老板了,老板就在我们办公室外面,于是我看见他摸出手机看了,面无表情,我石化了~~</text> <source> <a href="http://t.sina.com.cn">Web</a> </source> <favorited>false</favorited> <truncated>false</truncated> <geo xmlns:georss="http://www.georss.org/georss"> <georss:point>123.12 -122.39697</georss:point> </geo> <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>151387</id> <screen_name>151387</screen_name> <name>151387</name> <province>广东</province> <city>广州</city> <location>广东 广州</location> <description>blog: timyang.net</description> <profile_image_url></profile_image_url> <gender></gender> <email></email> <qq></qq> <msn></msn> <followers_count>0</followers_count> <friends_count>0</friends_count> <statuses_count>0</statuses_count> <favourites_count>0</favourites_count> <created_at>Thu Jan 01 08:00:00 +0800 1970</created_at> <following>false</following> <verified>false</verified> <profile_background_image_url></profile_background_image_url> <url></url> <protected>false</protected> <profile_background_color>9ae4e8</profile_background_color> <profile_text_color>000000</profile_text_color> <profile_link_color>0000ff</profile_link_color> <profile_sidebar_fill_color>e0ff92</profile_sidebar_fill_color> <profile_sidebar_border_color>87bc44</profile_sidebar_border_color> <utc_offset>28800</utc_offset> <time_zone>CST</time_zone> <profile_background_tile>false</profile_background_tile> <notifications>false</notifications> <geo_enabled>false</geo_enabled> </user> </status>
使用示例
cURL:
curl -u user:password -d "status=playing with cURL and the Sina API" http://api.t.sina.com.cn/statuses/update.xml