statuses/update

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

URL

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

格式

xml, json

HTTP请求方式

POST

是否需要身份验证

true

请求数限制

true

请求参数

• status: 必填参数， 要更新的微博信息。必须做URLEncode,信息内容部超过140个汉字,为空返回400错误。
• in_reply_to_status_id: 可选参数，@ 需要回复的微博信息ID, 这个参数只有在微博内容以 @username 开头才有意义。（即将推出）。
• lat: 可选参数，纬度，发表当前微博所在的地理位置，有效范围 -90.0到+90.0, +表示北纬。只有用户设置中geo_enabled=true时候地理位置才有效。(仅对受邀请的合作开发者开放)
• long: 可选参数，经度。有效范围-180.0到+180.0, +表示东经。(仅对受邀请的合作开发者开放)
• annotations: 可选参数，元数据。每条微博可以内含一个或多个子元数据。目前仅支持用户以json 数组格式提交的元数据，参数长度不超过512个字符。
• 请求参数格式: [{"type":{"app_mid":"123456abc","push_cmt":123,"attach":111}},{"type2":{"app_xmid":123}}] （即将推出）

使用说明

• 如果没有登录或超过发布上限，将返回403错误
• 如果in_reply_to_status_id不存在，将返回500错误
• 系统将忽略重复发布的信息。每次发布将比较最后一条发布消息，如果一样将被忽略。因此用户不能连续提交相同信息。

返回结果

注意geo信息仅对有地理位置的微博才有返回 XML示例:

<?xml version="1.0" encoding="UTF-8"?>
 <status>
   <created_at>Tue Dec 15 13:08:23 +0800 2009</created_at>
   <id>2</id>
   <text>莱斯科特头上有个月牙型的伤疤，要是他去扮演包公的话可以省去一笔包装费</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>23.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>
   <user>
     <id>135272</id>
     <screen_name>bbb</screen_name>
     <name>ddd</name>
     <province>13</province>
     <city>1000</city>
     <location>河北</location>
     <description>巾帼不让傻须眉。</description>
     <url>http://blog.sina.com.cn</url>
     <profile_image_url>http://tp4.sinaimg.cn/1352721827/50/1265540250</profile_image_url>
     <domain>maplelee0723</domain>
     <gender>f</gender>
     <followers_count>52</followers_count>
     <friends_count>23</friends_count>
     <statuses_count>54</statuses_count>
     <favourites_count>0</favourites_count>
     <created_at>Tue Jan 26 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>
 </status>

JSON示例:

	{	"created_at":"Fri Jul 30 14:01:57 +0800 2010",
		"id":1413384253,
		"text":"playing with cURL and the Sina API",
		"source":"<a href=\"http://open.t.sina.com.cn/wiki/index.php/SDK/\" rel=\"nofollow\">dabr for weibo</a>",
		"favorited":false,
		"truncated":false,
		"in_reply_to_status_id":"",
		"in_reply_to_user_id":"",
		"in_reply_to_screen_name":"",
		"geo":null,
		"user":{
		"id":10506,
		"screen_name":"hustfisher",
		"name":"hustfisher",
		"province":"44",
		"city":"1",
		"location":"广东 广州",
		"description":"",
		"url":"",
		"profile_image_url":"http://tp3.sinaimg.cn/10506/50/0","domain":"",
		"gender":"m",
		"followers_count":8,
		"friends_count":39,
		"statuses_count":169,
		"favourites_count":0,
		"created_at":"Tue Oct 20 00:00:00 +0800 2009",
		"following":false,
		"allow_all_act_msg":false,
		"geo_enabled":false,
		"verified":false},
		"annotations":[
		{"type":{"app_mid":"123456abc","push_cmt":123,"attach":111}},
		{"type2":{"app_xmid":123}}
		] 

使用示例

• xml:
• curl -u uid:password -d 'source=appkey&status=playing with cURL and the SinaAPI&annotations=[{"type":{"app_mid":"123456abc","push_cmt":123,"attach":111}},{"type2":{"app_xmid":123}}]' http://api.t.sina.com.cn/statuses/update.xml

• json:
• curl -u uid:password -d 'source=appkey&status=playing with cURL and the Sina API&annotations=[{"type":{"app_mid":"123456abc","push_cmt":123,"attach":111}},{"type2":{"app_xmid":123}}]' http://api.t.sina.com.cn/statuses/update.json