statuses/friends =

返回用户关注人列表，并返回关注人的最新微薄文章。按关注人的关注时间倒序返回，每次返回100个,通过cursor参数来取得多于100的关注人。当然也可以通过ID,screen_name,user_id参数来获取其他人的关注人列表。 Returns a user's friends, each with current status inline. They are ordered by the order in which the user followed them, most recently followed first, 100 at a time. (Please note that the result set isn't guaranteed to be 100 every time as suspended users will be filtered out.) Use the cursor option to access older friends. With no user specified, request defaults to the authenticated user's friends. It's also possible to request another user's friends list via the id, screen_name or user_id parameter.

URL:

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

Formats:

xml, json

HTTP Method(s):

GET

Requires Authentication (about authentication):

false unless requesting it from a protected user; if getting this data of a protected user, you must auth (and be allowed to see that user).

API rate limited (about rate limiting):

1 call per request

Parameters:

• id. 选填参数. 要获取好友的 UID或用户账户

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

• user_id. 选填参数. 要获取的UID

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

• screen_name. 选填参数. 要获取的账户ID

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

• cursor. 选填参数. 单页只能包含100个关注列表，为了获取更多则cursor默认从-1开始，通过增加或减少cursor来获取更多的关注列表

o Example: http://api.t.sina.com.cn/statuses/friends/barackobama.xml?cursor=-1 o Example: http://api.t.sina.com.cn/statuses/friends/barackobama.xml?cursor=1300794057949944903

• id. Optional. The ID or screen name of the user for whom to request a list of friends.

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

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

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

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

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

• cursor. Optional. Breaks the results into pages. A single page contains 100 users. This is recommended for users who are following many users. Provide a value of -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list.

o Example: http://api.t.sina.com.cn/statuses/friends/barackobama.xml?cursor=-1 o Example: http://api.t.sina.com.cn/statuses/friends/barackobama.xml?cursor=1300794057949944903

Unpaginated Response

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

<?xml version="1.0" encoding="UTF-8"?>
<users>
 <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>1031</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>
 <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>
 </status>
 </user>  
  ... truncated ...
</users>

Paginated Response

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

<?xml version="1.0" encoding="UTF-8"?>
<users_list>
<users type="array">
<user>
 <id>422</id>
 <name>Jason Shellen</name>
 <screen_name>shellen</screen_name>
 <location>iPhone: 37.889321,-122.173345</location>
 <description>CEO and founder of Thing Labs, makers of Brizzly! Former Blogger/Google dude, father of two little dudes.</description>
 <profile_image_url></profile_image_url>
 <url>http://www.shellen.com</url>
 <protected>false</protected>
 <followers_count>8526</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>DCDCDC</profile_sidebar_fill_color>
 <profile_sidebar_border_color>D22900</profile_sidebar_border_color>
 <friends_count>375</friends_count>
 <created_at>Thu Jul 06 22:36:22 +0000 2006</created_at>
 <favourites_count>1179</favourites_count>
 <utc_offset>-28800</utc_offset>
 <time_zone>Pacific Time (US & Canada)</time_zone>
 <profile_background_image_url></profile_background_image_url>
 <profile_background_tile>true</profile_background_tile>
 <statuses_count>2710</statuses_count>
 <notifications></notifications>
 <verified>false</verified>
 <following></following>
 <status>
   <created_at>Thu Sep 24 19:31:58 +0000 2009</created_at>
   <id>4349531340</id>
   <text>I think @jasonfried just went from "prickly fellow" to "kind of a dick" in my book. Eyes on your own paper Fried.</text>
   <source><a href="http://www.brizzly.com" rel="nofollow">Brizzly</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>
 </status>
</user>
 ... truncated ... 
</users>
<next_cursor>1299072354878293926</next_cursor>
<previous_cursor>0</previous_cursor>
</users_list>

Notes:

• 如果没有提供cursor参数，将只返回最前面的100个关注列表
• 先前记录页的分页机制仍然存在，但会过时。请迁移到基cursor分页来提高可靠性和性能。
• If the cursor parameter is not provided, only the first 100 users in the set will be returned.
• The previously documented page-based pagination mechanism is still in production, but will be deprecated. Please migrate to cursor-based pagination for increased reliability and performance.

Usage examples:

cURL (about cURL):

curl -u user:password http://api.t.sina.com.cn/statuses/friends.xml

curl http://api.t.sina.com.cn/statuses/friends/dougw.xml

curl http://api.t.sina.com.cn/statuses/friends/dougw.xml?cursor=-1