Friends/ids
目录 |
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
使用示例
cURL: curl -u user:password http://api.t.sina.com.cn/friends/ids.xml curl http://api.t.sina.com.cn/statuses/friends/ids/timyang.xml curl http://api.t.sina.com.cn/statuses/friends/ids/timyang.xml?cursor=-1