2009年11月3日 (二) 14:42的版本

statuses/user_timeline

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. 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