Statuses/repost timeline

跳转到: 导航, 搜索
(创建新页面为 '== statuses/update == 发布一条微博信息。请求必须用POST方式提交。为防止重复,发布的信息与当前最新信息一样话,将会被忽略。 === URL=…')
 
(statuses/update)
第1行: 第1行:
== statuses/update ==
+
==statuses/repost_timeline ==
发布一条微博信息。请求必须用POST方式提交。为防止重复,发布的信息与当前最新信息一样话,将会被忽略。
+
返回一条原创微博的最新n条转发微博信息。非原创微博无法进行查询。
  
 
=== URL===
 
=== URL===
http://api.t.sina.com.cn/statuses/update.format
+
http://api.t.sina.com.cn/statuses/repost_timeline.format
  
 
=== 格式===
 
=== 格式===
第9行: 第9行:
  
 
=== HTTP请求方式===
 
=== HTTP请求方式===
POST
+
GET
 
   
 
   
 
=== 是否需要身份验证===
 
=== 是否需要身份验证===
第18行: 第18行:
  
 
=== 请求参数===
 
=== 请求参数===
* status: 必填参数, 要更新的微博信息。必须做URLEncode,信息内容部超过140个汉字,为空返回400错误。
+
*id: (必选)原创微博ID. 返回转发这个微博的转发微博列表。
* in_reply_to_status_id: 可选参数,@ 需要回复的微博信息ID, 这个参数只有在微博内容以 @username 开头才有意义。(即将推出)。
+
示例: http://api.t.sina.com.cn/statuses/repost_timeline.xml?id=123456
* lat: 可选参数,纬度,发表当前微博所在的地理位置,有效范围 -90.0到+90.0, +表示北纬。只有用户设置中geo_enabled=true时候地理位置才有效。(仅对受邀请的合作开发者开放)
+
*since_id: 微博信息ID. 只返回ID比since_id大(比since_id时间晚的)的微博信息内容。
* long: 可选参数,经度。有效范围-180.0到+180.0, +表示东经。(仅对受邀请的合作开发者开放)
+
示例: http://api.t.sina.com.cn/statuses/repost_timeline.xml?since_id=12345
* annotations: 可选参数,元数据。每条微博可以内含一个或多个子元数据。目前仅支持用户以json 数组格式提交的元数据,参数长度不超过512个字符。
+
*max_id: 微博信息ID. 返回ID不大于max_id的微博信息内容。
* 请求参数格式: [{"type":{"app_mid":"123456abc","push_cmt":123,"attach":111}},{"type2":{"app_xmid":123}}] (即将推出)
+
示例: http://api.t.sina.com.cn/statuses/repost_timeline.xml?max_id=54321
 
+
*count: 每次返回的最大记录数,不能超过200,默认20.
=== 使用说明===
+
示例: http://api.t.sina.com.cn/statuses/repost_timeline.xml?count=5
 
+
*page: 返回结果的页序号, 默认1
* 如果没有登录或超过发布上限,将返回403错误
+
示例: http://api.t.sina.com.cn/statuses/repost_timeline.xml?page=3
* 如果in_reply_to_status_id不存在,将返回500错误
+
* 系统将忽略重复发布的信息。每次发布将比较最后一条发布消息,如果一样将被忽略。因此用户不能连续提交相同信息。
+
  
 
=== 返回结果 ===
 
=== 返回结果 ===
 
注意geo信息仅对有地理位置的微博才有返回
 
注意geo信息仅对有地理位置的微博才有返回
 
XML示例:
 
XML示例:
<?xml version="1.0" encoding="UTF-8"?>
+
  <?xml version="1.0" encoding="UTF-8"?>
 +
<statuses>
 
   <status>
 
   <status>
     <created_at>Tue Dec 15 13:08:23 +0800 2009</created_at>
+
     <created_at>Mon Nov 15 17:51:22 +0800 2010</created_at>
     <id>2</id>
+
     <id>3660618965</id>
     <text>莱斯科特头上有个月牙型的伤疤,要是他去扮演包公的话可以省去一笔包装费</text>
+
     <text>转发微博。</text>
 
     <source>
 
     <source>
       <a href="http://t.sina.com.cn">Web</a>
+
       <a href="http://t.sina.com.cn">新浪微博</a>
 
     </source>
 
     </source>
 
     <favorited>false</favorited>
 
     <favorited>false</favorited>
 
     <truncated>false</truncated>
 
     <truncated>false</truncated>
     <geo xmlns:georss="http://www.georss.org/georss">
+
     <geo/>
      <georss:point>23.12 -122.39697</georss:point>
+
     <in_reply_to_status_id/>
    </geo>
+
     <in_reply_to_user_id/>
     <in_reply_to_status_id></in_reply_to_status_id>
+
     <in_reply_to_screen_name/>
     <in_reply_to_user_id></in_reply_to_user_id>
+
     <in_reply_to_screen_name></in_reply_to_screen_name>
+
 
     <user>
 
     <user>
       <id>135272</id>
+
       <id>1734528095</id>
       <screen_name>bbb</screen_name>
+
       <screen_name>jkl0000</screen_name>
       <name>ddd</name>
+
       <name>jkl0000</name>
       <province>13</province>
+
       <province>11</province>
 
       <city>1000</city>
 
       <city>1000</city>
       <location>河北</location>
+
       <location>北京</location>
       <description>巾帼不让傻须眉。</description>
+
       <description>abcdef</description>
       <url>http://blog.sina.com.cn</url>
+
       <url>http://blog.sina.com.cn/jkl0000</url>
       <profile_image_url>http://tp4.sinaimg.cn/1352721827/50/1265540250</profile_image_url>
+
       <profile_image_url>http://tp4.sinaimg.cn/1734528095/50/1284023727/1</profile_image_url>
       <domain>maplelee0723</domain>
+
       <domain/>
       <gender>f</gender>
+
       <gender>m</gender>
       <followers_count>52</followers_count>
+
       <followers_count>44</followers_count>
       <friends_count>23</friends_count>
+
       <friends_count>158</friends_count>
       <statuses_count>54</statuses_count>
+
       <statuses_count>772</statuses_count>
 
       <favourites_count>0</favourites_count>
 
       <favourites_count>0</favourites_count>
       <created_at>Tue Jan 26 00:00:00 +0800 2010</created_at>
+
       <created_at>Mon Apr 26 00:00:00 +0800 2010</created_at>
 
       <following>false</following>
 
       <following>false</following>
 
       <verified>false</verified>
 
       <verified>false</verified>
       <allow_all_act_msg>false</allow_all_act_msg>
+
       <allow_all_act_msg>true</allow_all_act_msg>
       <geo_enabled>false</geo_enabled>
+
       <geo_enabled>true</geo_enabled>
 
     </user>
 
     </user>
 +
    <retweeted_status>
 +
      <created_at>Wed Nov 10 14:44:58 +0800 2010</created_at>
 +
      <id>3553819645</id>
 +
      <text>发现一件神奇的事情</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>1822257145</id>
 +
        <screen_name>wh_liang</screen_name>
 +
        <name>wh_liang</name>
 +
        <province>11</province>
 +
        <city>8</city>
 +
        <location>北京 海淀区</location>
 +
        <description/>
 +
        <url>http://1</url>
 +
        <profile_image_url>http://tp2.sinaimg.cn/1822257145/50/1285426565/0</profile_image_url>
 +
        <domain>liangwenhhong</domain>
 +
        <gender>f</gender>
 +
        <followers_count>57</followers_count>
 +
        <friends_count>77</friends_count>
 +
        <statuses_count>44</statuses_count>
 +
        <favourites_count>3</favourites_count>
 +
        <created_at>Tue Sep 21 00:00:00 +0800 2010</created_at>
 +
        <following>false</following>
 +
        <verified>false</verified>
 +
        <allow_all_act_msg>true</allow_all_act_msg>
 +
        <geo_enabled>true</geo_enabled>
 +
      </user>
 +
    </retweeted_status>
 
   </status>
 
   </status>
 +
</statuses>
 +
  
 
JSON示例:
 
JSON示例:
  
  { "created_at":"Fri Jul 30 14:01:57 +0800 2010",
+
  [
"id":1413384253,
+
    {
"text":"playing with cURL and the Sina API",
+
        "created_at": "Mon Nov 15 17:51:22 +0800 2010",
"source":"<a href=\"http://open.t.sina.com.cn/wiki/index.php/SDK/\" rel=\"nofollow\">dabr for weibo</a>",
+
        "favorited": false,
"favorited":false,
+
        "geo": null,
"truncated":false,
+
        "id": 3660618965,
"in_reply_to_status_id":"",
+
        "in_reply_to_screen_name": "",
"in_reply_to_user_id":"",
+
        "in_reply_to_status_id": "",
"in_reply_to_screen_name":"",
+
        "in_reply_to_user_id": "",
"geo":null,
+
        "retweeted_status": {
"user":{
+
            "created_at": "Wed Nov 10 14:44:58 +0800 2010",  
"id":10506,
+
            "favorited": false,
"screen_name":"hustfisher",
+
            "geo": null,
"name":"hustfisher",
+
            "id": 3553819645,  
"province":"44",
+
            "in_reply_to_screen_name": "",
"city":"1",
+
            "in_reply_to_status_id": "",
"location":"广东 广州",
+
            "in_reply_to_user_id": "",  
"description":"",
+
            "source": "<a href=\"http://t.sina.com.cn\" rel=\"nofollow\">\u65b0\u6d6a\u5fae\u535a</a>",  
"url":"",
+
            "text": "\u53d1\u73b0\u4e00\u4ef6\u795e\u5947\u7684\u4e8b\u60c5\uff0c\u6211\u7684\u7535\u8bdd\u53f7\u7801\u88ab\u7cfb\u7edf\u5c4f\u853d\u4e86\uff0c\u4e0d\u80fd\u53d1\u9001\uff01\uff01",  
"profile_image_url":"http://tp3.sinaimg.cn/10506/50/0","domain":"",
+
            "truncated": false,  
"gender":"m",
+
            "user": {
"followers_count":8,
+
                "allow_all_act_msg": true,  
"friends_count":39,
+
                "city": "8",  
"statuses_count":169,
+
                "created_at": "Tue Sep 21 00:00:00 +0800 2010",  
"favourites_count":0,
+
                "description": "",  
"created_at":"Tue Oct 20 00:00:00 +0800 2009",
+
                "domain": "liangwenhhong",  
"following":false,
+
                "favourites_count": 3,
"allow_all_act_msg":false,
+
                "followers_count": 57,  
"geo_enabled":false,
+
                "following": false,  
"verified":false},
+
                "friends_count": 77,  
"annotations":[
+
                "gender": "f",  
{"type":{"app_mid":"123456abc","push_cmt":123,"attach":111}},
+
                "geo_enabled": true,
{"type2":{"app_xmid":123}}
+
                "id": 1822257145,  
]  
+
                "location": "\u5317\u4eac \u6d77\u6dc0\u533a",  
 +
                "name": "wh_liang",  
 +
                "profile_image_url": "http://tp2.sinaimg.cn/1822257145/50/1285426565/0",  
 +
                "province": "11",  
 +
                "screen_name": "wh_liang",  
 +
                "statuses_count": 44,  
 +
                "url": "http://1",  
 +
                "verified": false
 +
            }
 +
        },  
 +
        "source": "<a href=\"http://t.sina.com.cn\" rel=\"nofollow\">\u65b0\u6d6a\u5fae\u535a</a>",  
 +
        "text": "\u8f6c\u53d1\u5fae\u535a\u3002",
 +
        "truncated": false,
 +
        "user": {
 +
            "allow_all_act_msg": true,
 +
            "city": "1000",
 +
            "created_at": "Mon Apr 26 00:00:00 +0800 2010",  
 +
            "description": "abcdef",
 +
            "domain": "",
 +
            "favourites_count": 0,
 +
            "followers_count": 44,
 +
            "following": false,  
 +
            "friends_count": 158,
 +
            "gender": "m",  
 +
            "geo_enabled": true,  
 +
            "id": 1734528095,  
 +
            "location": "\u5317\u4eac",
 +
            "name": "jkl0000",
 +
            "profile_image_url": "http://tp4.sinaimg.cn/1734528095/50/1284023727/1",  
 +
            "province": "11",  
 +
            "screen_name": "jkl0000",  
 +
            "statuses_count": 772,
 +
            "url": "http://blog.sina.com.cn/jkl0000",
 +
            "verified": false
 +
        }
 +
    }
 +
]
 +
 
  
 
=== 使用示例===
 
=== 使用示例===

2010年11月15日 (一) 18:09的版本

目录

statuses/repost_timeline

返回一条原创微博的最新n条转发微博信息。非原创微博无法进行查询。

URL

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

格式

xml, json

HTTP请求方式

GET

是否需要身份验证

true

请求数限制

true

请求参数

  • id: (必选)原创微博ID. 返回转发这个微博的转发微博列表。

示例: http://api.t.sina.com.cn/statuses/repost_timeline.xml?id=123456

  • since_id: 微博信息ID. 只返回ID比since_id大(比since_id时间晚的)的微博信息内容。

示例: http://api.t.sina.com.cn/statuses/repost_timeline.xml?since_id=12345

  • max_id: 微博信息ID. 返回ID不大于max_id的微博信息内容。

示例: http://api.t.sina.com.cn/statuses/repost_timeline.xml?max_id=54321

  • count: 每次返回的最大记录数,不能超过200,默认20.

示例: http://api.t.sina.com.cn/statuses/repost_timeline.xml?count=5

  • page: 返回结果的页序号, 默认1

示例: http://api.t.sina.com.cn/statuses/repost_timeline.xml?page=3

返回结果

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

 <?xml version="1.0" encoding="UTF-8"?>

<statuses>

 <status>
   <created_at>Mon Nov 15 17:51:22 +0800 2010</created_at>
   <id>3660618965</id>
   <text>转发微博。</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>1734528095</id>
     <screen_name>jkl0000</screen_name>
     <name>jkl0000</name>
     <province>11</province>
     <city>1000</city>
     <location>北京</location>
     <description>abcdef</description>
     <url>http://blog.sina.com.cn/jkl0000</url>
     <profile_image_url>http://tp4.sinaimg.cn/1734528095/50/1284023727/1</profile_image_url>
     <domain/>
     <gender>m</gender>
     <followers_count>44</followers_count>
     <friends_count>158</friends_count>
     <statuses_count>772</statuses_count>
     <favourites_count>0</favourites_count>
     <created_at>Mon Apr 26 00:00:00 +0800 2010</created_at>
     <following>false</following>
     <verified>false</verified>
     <allow_all_act_msg>true</allow_all_act_msg>
     <geo_enabled>true</geo_enabled>
   </user>
   <retweeted_status>
     <created_at>Wed Nov 10 14:44:58 +0800 2010</created_at>
     <id>3553819645</id>
     <text>发现一件神奇的事情</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>1822257145</id>
       <screen_name>wh_liang</screen_name>
       <name>wh_liang</name>
       <province>11</province>
       <city>8</city>
       <location>北京 海淀区</location>
       <description/>
       <url>http://1</url>
       <profile_image_url>http://tp2.sinaimg.cn/1822257145/50/1285426565/0</profile_image_url>
       <domain>liangwenhhong</domain>
       <gender>f</gender>
       <followers_count>57</followers_count>
       <friends_count>77</friends_count>
       <statuses_count>44</statuses_count>
       <favourites_count>3</favourites_count>
       <created_at>Tue Sep 21 00:00:00 +0800 2010</created_at>
       <following>false</following>
       <verified>false</verified>
       <allow_all_act_msg>true</allow_all_act_msg>
       <geo_enabled>true</geo_enabled>
     </user>
   </retweeted_status>
 </status>

</statuses>


JSON示例:

	[
   {
       "created_at": "Mon Nov 15 17:51:22 +0800 2010", 
       "favorited": false, 
       "geo": null, 
       "id": 3660618965, 
       "in_reply_to_screen_name": "", 
       "in_reply_to_status_id": "", 
       "in_reply_to_user_id": "", 
       "retweeted_status": {
           "created_at": "Wed Nov 10 14:44:58 +0800 2010", 
           "favorited": false, 
           "geo": null, 
           "id": 3553819645, 
           "in_reply_to_screen_name": "", 
           "in_reply_to_status_id": "", 
           "in_reply_to_user_id": "", 
           "source": "<a href=\"http://t.sina.com.cn\" rel=\"nofollow\">\u65b0\u6d6a\u5fae\u535a</a>", 
           "text": "\u53d1\u73b0\u4e00\u4ef6\u795e\u5947\u7684\u4e8b\u60c5\uff0c\u6211\u7684\u7535\u8bdd\u53f7\u7801\u88ab\u7cfb\u7edf\u5c4f\u853d\u4e86\uff0c\u4e0d\u80fd\u53d1\u9001\uff01\uff01", 
           "truncated": false, 
           "user": {
               "allow_all_act_msg": true, 
               "city": "8", 
               "created_at": "Tue Sep 21 00:00:00 +0800 2010", 
               "description": "", 
               "domain": "liangwenhhong", 
               "favourites_count": 3, 
               "followers_count": 57, 
               "following": false, 
               "friends_count": 77, 
               "gender": "f", 
               "geo_enabled": true, 
               "id": 1822257145, 
               "location": "\u5317\u4eac \u6d77\u6dc0\u533a", 
               "name": "wh_liang", 
               "profile_image_url": "http://tp2.sinaimg.cn/1822257145/50/1285426565/0", 
               "province": "11", 
               "screen_name": "wh_liang", 
               "statuses_count": 44, 
               "url": "http://1", 
               "verified": false
           }
       }, 
       "source": "<a href=\"http://t.sina.com.cn\" rel=\"nofollow\">\u65b0\u6d6a\u5fae\u535a</a>", 
       "text": "\u8f6c\u53d1\u5fae\u535a\u3002", 
       "truncated": false, 
       "user": {
           "allow_all_act_msg": true, 
           "city": "1000", 
           "created_at": "Mon Apr 26 00:00:00 +0800 2010", 
           "description": "abcdef", 
           "domain": "", 
           "favourites_count": 0, 
           "followers_count": 44, 
           "following": false, 
           "friends_count": 158, 
           "gender": "m", 
           "geo_enabled": true, 
           "id": 1734528095, 
           "location": "\u5317\u4eac", 
           "name": "jkl0000", 
           "profile_image_url": "http://tp4.sinaimg.cn/1734528095/50/1284023727/1", 
           "province": "11", 
           "screen_name": "jkl0000", 
           "statuses_count": 772, 
           "url": "http://blog.sina.com.cn/jkl0000", 
           "verified": false
       }
   }

]


使用示例

  • 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