(创建新页面为 '{{api_desc_v2| uri=friendships/groups| desc=获取当前登录用户的好友分组列表| httpMethod=GET| needAuth=是| level={{Api_L2}}| rateLimit=是| params= {{api_args|uid|…') |
|||
| 第6行： | 第6行： | ||
level={{Api_L2}}| | level={{Api_L2}}| | ||
rateLimit=是| | rateLimit=是| | ||
| − | params= | + | params=| |
| − | + | ||
result= | result= | ||
<pre> | <pre> | ||
| − | + | { | |
| + | "lists": [ | ||
| + | { | ||
| + | "id": 201101270045006180, | ||
| + | "idstr": "201101270045006191", | ||
| + | "name": "同学" | ||
| + | }, | ||
| + | { | ||
| + | "id": 201110270443452670, | ||
| + | "idstr": "201110270443452677", | ||
| + | "name": "同事" | ||
| + | }, | ||
| + | ... | ||
| + | ], | ||
| + | "next_cursor": 0, | ||
| + | "previous_cursor": 0 | ||
| + | } | ||
</pre>| | </pre>| | ||
resultDes=无| | resultDes=无| | ||
| 第18行： | 第33行： | ||
*"未分组"的分组ID为0；| | *"未分组"的分组ID为0；| | ||
otherInfo=无 | otherInfo=无 | ||
| − | }} | + | }}{{#a:showgrade}} |
2011年11月29日 (二) 10:38的版本
friendships/groups
获取当前登录用户的好友分组列表
URL
https://api.weibo.com/2/friendships/groups.json
支持格式
JSON
HTTP请求方式
GET
是否需要登录
是
关于登录授权，参见 如何登录授权
访问授权限制
访问级别：高级接口（需要授权）
频次限制：是
关于频次限制，参见 接口访问权限说明
请求参数
| 必选 | 类型及范围 | 说明 | |
|---|---|---|---|
| access_token | true | string | 采用OAuth授权方式为必填参数，OAuth授权后获得。 |
注意事项
- 返回的数据按设置的分组顺序排序；
- 好友分组上限为20，“未分组”不计入上限；
- "未分组"的分组ID为0；
调用样例及调试工具
返回结果
JSON示例
{
"lists": [
{
"id": 201101270045006180,
"idstr": "201101270045006191",
"name": "同学"
},
{
"id": 201110270443452670,
"idstr": "201110270443452677",
"name": "同事"
},
...
],
"next_cursor": 0,
"previous_cursor": 0
}
关于错误返回值与错误代码，参见 错误代码说明
返回字段说明
无
其他
无
相关问题
{{{relat_qa}}}
到 帮助中心 查看更多问题或提问
