2010年1月8日 (五) 16:39的版本

friends/ids

返回用户关注对象uid列表

URL

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

格式

xml, json

HTTP请求方式

GET

是否需要身份验证

false

请求数限制

1 call per request

请求参数

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

o 示例: http://api.t.sina.com.cn/friends/ids/12345.xml or http://api.t.sina.com.cn/statuses/friends/bob.xml

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

o 示例: http://api.t.sina.com.cn/friends/ids.xml?user_id=1401881

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

o 示例: http://api.t.sina.com.cn/friends/ids.xml?screen_name=101010

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

o 示例: http://api.t.sina.com.cn/friends/ids.xml?cursor=-1 o 示例: http://api.t.sina.com.cn/friends/ids.xml?cursor=1300794057949944903

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

o Example: http://api.t.sina.com.cn/friends/ids.xml?&count=200

未分页结果

XML示例:

<?xml version="1.0" encoding="UTF-8"?> 
<id_list>
    <ids>
         <id>30592818</id>
         <id>21249843</id>
         ... truncated ...
    </ids>
    <next_cursor>1288724293877798413</next_cursor>
    <previous_cursor>-1300794057949944903</previous_cursor>
</id_list>

Notes

• 如果没有提供cursor参数，将只返回最前面的5000个关注id

使用示例

• xml

curl -u user:password http://api.t.sina.com.cn/friends/timyang.xml or http://api.t.sina.com.cn/friends/ids/timyang.xml or http://api.t.sina.com.cn/friends/ids/timyang.xml?cursor=3

• json

curl -u user:password http://api.t.sina.com.cn/friends/timyang.json or http://api.t.sina.com.cn/friends/ids/timyang.json or http://api.t.sina.com.cn/friends/ids/timyang.json?cursor=3