Friends/ids
(→friends/ids) |
|||
第1行: | 第1行: | ||
− | + | {{api_desc2| | |
− | + | uri=friends/ids| | |
− | + | desc=返回用户关注的一组用户的ID列表| | |
− | = | + | format=XML/JSON| |
− | + | httpMethod=GET| | |
− | + | needAuth=true| | |
− | === | + | rateLimit=true| |
− | + | params={{api_args|:id|false|int64/string|用户的ID(int64)或者微博昵称(string)。该参数为REST风格的参数,用法参见注意事项。}} | |
− | + | {{api_args|user_id|false|int64|要获取的好友列表所属的用户的ID。}} | |
− | {{ | + | {{api_args|screen_name|false|string|要获取的好友列表所属的用户微博昵称。}} |
− | + | {{api_args|count|false|int,默认500,最大5000|单页记录数。}} | |
− | + | {{api_args|cursor|false|int,默认-1。|游标。单页最多返回5000条记录。通过增加或减少cursor值来获取更多的关注列表。如果提供该参数,返回结果中将给出下一页的起始游标。}}| | |
− | + | getParam=&user_id=11051| | |
− | + | postParam=| | |
− | + | result= | |
− | + | ===XML示例=== | |
− | + | <pre> | |
− | + | <?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> | |
− | === | + | </pre> |
− | + | ===JSON示例=== | |
− | + | <pre> | |
− | + | { | |
− | + | "ids": | |
− | + | [ | |
− | + | 9448, | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
16825, | 16825, | ||
..... | ..... | ||
− | + | ], | |
− | + | "next_cursor":3, | |
− | + | "previous_cursor":0 | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
} | } | ||
− | + | </pre>| | |
− | + | useAge= | |
− | + | * :id为REST风格的参数,使用该参数的URL为:<br/> http://api.t.sina.com.cn/friends/ids/:id.format <br/> 使用示例如下:<br/> http://api.t.sina.com.cn/friends/ids/123456.xml?source=appkey<br/>http://api.t.sina.com.cn/friends/ids/123456.json?source=appkey| | |
− | + | otherInfo=无 | |
− | + | }} | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | } | + | |
− | + |
2010年12月6日 (一) 17:13的最后版本
目录 |
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