Friends/ids
目录 |
friends/ids
返回用户关注的一组用户的ID列表
URL
http://api.t.sina.com.cn/friends/ids.(json%7Cxml)
支持格式
XML/JSON
HTTP请求方式
GET
是否需要登录
true
关于授权机制，参见授权机制声明
请求数限制
true
关于请求数限制，参见接口访问权限说明
请求参数
| 必选 | 类型及范围 | 说明 | |
|---|---|---|---|
| source | true | string | 申请应用时分配的AppKey，调用接口时候代表应用的唯一身份。（采用OAuth授权方式不需要此参数） |
| :id | false | int64/string | 用户的ID(int64)或者微博昵称(string)。该参数为REST风格的参数，用法参见注意事项。 |
| user_id | false | int64 | 要获取的好友列表所属的用户的ID。 |
| screen_name | false | string | 要获取的好友列表所属的用户微博昵称。 |
| count | false | int，默认500，最大5000 | 单页记录数。 |
| cursor | false | int，默认-1。 | 游标。单页最多返回5000条记录。通过增加或减少cursor值来获取更多的关注列表。如果提供该参数，返回结果中将给出下一页的起始游标。 |
注意事项
- :id为REST风格的参数，使用该参数的URL为：
http://api.t.sina.com.cn/friends/ids/:id.format
使用示例如下：
http://api.t.sina.com.cn/friends/ids/123456.xml?source=appkey
http://api.t.sina.com.cn/friends/ids/123456.json?source=appkey
返回结果
XML示例
<?xml version="1.0" encoding="UTF-8"?>
<id_list>
<ids>
<id>9448</id>
<id>16825</id>
......
</ids>
<next_cursor>3</next_cursor>
<previous_cursor>0</previous_cursor>
</id_list>
JSON示例
{
"ids":
[
9448,
16825,
.....
],
"next_cursor":3,
"previous_cursor":0
}
其他
无
文档更新时间: 2010-12-06
