statuses/user_timeline

返回登陆用户的发布的最近20条围脖信息。这个是网络上时间轴上或第三方个信息页是等同的。

Returns the 20 most recent statuses posted from the authenticating user. It's also possible to request another user's timeline via the id parameter. This is the equivalent of the Web /<user> page for your own user, or the profile page for a third party.

URL:

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

Formats:

xml, json, rss, atom

HTTP Method(s):

GET

Requires Authentication (about authentication):

true, if requesting a protected user's timeline

API rate limited (about rate limiting):

1 call per request

Parameters:

• id： 可选参数. 根据指定用户ID或用户帐号来返回围脖信息。

o Example: http://api.t.sina.com.cn/statuses/user_timeline/12345.xml or http://twitter.com/statuses/user_timeline/bob.json.

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

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

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

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

• id. Optional. Specifies the ID or screen name of the user for whom to return the user_timeline.

o Example: http://api.t.sina.com.cn/statuses/user_timeline/12345.xml or http://twitter.com/statuses/user_timeline/bob.json.

• user_id. Optional. Specfies the ID of the user for whom to return the user_timeline. Helpful for disambiguating when a valid user ID is also a valid screen name.

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

• screen_name. Optional. Specfies the screen name of the user for whom to return the user_timeline. Helpful for disambiguating when a valid screen name is also a user ID.

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

• since_id. Optional. Returns only statuses with an ID greater than (that is, more recent than) the specified ID.

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

• max_id. Returns only statuses with an ID less than (that is, older than) or equal to the specified ID.

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

• count. Optional. Specifies the number of statuses to retrieve. May not be greater than 200.

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

• page. Optional. Specifies the page of results to retrieve. Note: there are pagination limits.

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

Usage notes:

• You will only be able to access the latest 3200 statuses from a user's timeline due to pagination limits.

Response

(about return values): XML example (truncated):

<?xml version="1.0" encoding="UTF-8"?>
<statuses>
<status>
 <created_at>Tue Apr 07 22:52:51 +0000 2009</created_at>
 <id>1472669360</id>
 <text>At least I can get your humor through tweets. RT @abdur: I don't mean this in a bad way, but genetically speaking your a cul-de-sac.</text>
 <source><a href="http://www.tweetdeck.com/">TweetDeck</a></source>
 <truncated>false</truncated>
 <in_reply_to_status_id></in_reply_to_status_id>
 <in_reply_to_user_id></in_reply_to_user_id>
 <favorited>false</favorited>
 <in_reply_to_screen_name></in_reply_to_screen_name>
 <user>
  <id>1401881</id>
  <name>Doug Williams</name>
  <screen_name>dougw</screen_name>
  <location>San Francisco, CA</location>
  <description>Twitter API Support. Internet, greed, users, dougw and opportunities are my passions.</description>
  <profile_image_url></profile_image_url>
  <url>http://www.igudo.com</url>
  <protected>false</protected>
  <followers_count>1027</followers_count>
  <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>
  <friends_count>293</friends_count>
  <created_at>Sun Mar 18 06:42:26 +0000 2007</created_at>
  <favourites_count>0</favourites_count>
  <utc_offset>-18000</utc_offset>
  <time_zone>Eastern Time (US & Canada)</time_zone>
  <profile_background_image_url></profile_background_image_url>
  <profile_background_tile>false</profile_background_tile>
  <statuses_count>3390</statuses_count>
  <notifications>false</notifications>
  <following>false</following>
  <verified>true</verified>
 </user>
 <geo/>
</status>
    ... truncated ...
</statuses>

Usage examples:

cURL (about cURL): curl http://api.t.sina.com.cn/statuses/user_timeline.xml?screen_name=dougw