2009年11月18日 (三) 13:58的版本

statuses/user_timeline

返回用户的发布的最近n条信息，和用户微博页面返回内容是一致的。此接口也可以请求其他用户的最新发表微博。

URL:

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

格式:

xml, json, rss, atom

HTTP请求方式:

GET

是否需要登录::

false

请求数限制:

1 call per request

参数:

• id： 可选参数. 根据指定用户UID或用户帐号来返回微博信息。

o Example: http://api.t.sina.com.cn/statuses/user_timeline/12345.xml

• user_id： 可选参数. 指定用户UID来返回微博信息，主要是用来区分用户UID跟用户账号一样，产生歧义的时候，特别是在用户账号为数字导致和用户Uid发生歧义。

o Example: http://api.t.sina.com.cn/statuses/user_timeline.xml?user_id=1401881

• screen_name. 可选参数. 指定用户账号来返回微博信息，主要是用来区分用户UID跟用户账号一样，产生歧义的时候。

o Example: http://api.t.sina.com.cn/statuses/user_timeline.xml?screen_name=101010

• since_id： 可选参数. 返回ID比数值since_id大（比since_id时间晚的）的微博信息。

o Example: http://api.t.sina.com.cn/statuses/user_timeline.xml?since_id=12345

• max_id： 返回ID不大于max_id(时间不晚于max_id)的微博信息。

o Example: http://api.t.sina.com.cn/statuses/user_timeline.xml?max_id=54321

• count： 可选参数. 每次返回的最大记录数（即页面大小），不大于200。

o Example: http://api.t.sina.com.cn/statuses/user_timeline.xml?count=200

• page： 可选参数. 返回结果的页序号。注意：有分页限制。

o Example: http://api.t.sina.com.cn/statuses/user_timeline.rss?page=3

使用说明:

• 由于分页限制，最多只能返回用户最新的300条微博信息

返回

XML示例:

<?xml version="1.0" encoding="UTF-8"?>
<statuses>
<status>
<id>8374590856</id>
   <text>微博平台很重要的一点在于多渠道，使得用户可以随时随地随意收发信息，我们会在这个 方向努力的。</text>
   <source>
     <a href="http://t.sina.com.cn">Web</a>
   </source>
   <favorited>false</favorited>
   <truncated>false</truncated>
   <created_at>Tue Nov 17 20:11:24 +0800 2009</created_at>
   <user>
     <id>10503</id>
     <screen_name>timyang</screen_name>
     <name>Tim Yang</name>
     <location>广州</location>
     <description>blog: timyang.net</description>
     <profile_image_url>http://tt8.sinaimg.cn/10503/50/1256306049</profile_image_url>
     <followers_count>0</followers_count>
     <friends_count>0</friends_count>
     <statuses_count>0</statuses_count>
     <favourites_count>0</favourites_count>
   </user>
</status>
    ... truncated ...
</statuses>

使用示例:

cURL: curl http://api.t.sina.com.cn/statuses/user_timeline.xml?screen_name=timyang