跳转到: 导航, 搜索
第1行: 第1行:
 
{{api_desc_v2|
 
{{api_desc_v2|
 
uri=friendships/groups/members/ids|
 
uri=friendships/groups/members/ids|
desc=获取某一好友分组下的成员列表的ID|
+
desc=获取当前登录用户某一好友分组下的成员列表的ID|
 
httpMethod=GET|
 
httpMethod=GET|
 
needAuth=是|
 
needAuth=是|
第7行: 第7行:
 
rateLimit=是|
 
rateLimit=是|
 
params=
 
params=
{{api_args|uid|false|int64|好友分组的所有者UID,默认不填为当前登录用户。}}
 
 
{{api_args|list_id|true|int64|好友分组ID,建议使用返回值里的idstr。}}
 
{{api_args|list_id|true|int64|好友分组ID,建议使用返回值里的idstr。}}
{{api_args|count|false|int|单页返回的记录条数,默认为20,最大不超过200。}}
+
{{api_args|count|false|int|单页返回的记录条数,默认为50,最大不超过200。}}
 
{{api_args|cursor|false|int|分页返回结果的游标,下一页用返回值里的next_cursor,上一页用previous_cursor,默认为0。}}|
 
{{api_args|cursor|false|int|分页返回结果的游标,下一页用返回值里的next_cursor,上一页用previous_cursor,默认为0。}}|
 
result=
 
result=
第15行: 第14行:
 
{
 
{
 
     "users": [
 
     "users": [
         1404376560,
+
         185379589,
 +
        187271210,
 +
        164201729,
 +
        270053774,
 +
        223557223,
 
         ...
 
         ...
 
     ],
 
     ],
     "next_cursor": 0,
+
     "next_cursor": 5,
 
     "previous_cursor": 0,
 
     "previous_cursor": 0,
     "total_number": 10
+
     "total_number": 41
 
}
 
}
 
</pre>|
 
</pre>|
 
resultDes=无|
 
resultDes=无|
 
useAge=
 
useAge=
*当要查询的分组为私有分组时,当前登录用户必须为分组的所有者;
+
*当前登录用户不是指定好友分组的所有者时,只能获取所有人可见的公开分组、和组内成员可见的公开分组(此时当前登录用户必须是组内成员)的分组成员;
+
|
*最多返回最新300位成员;|
+
 
otherInfo=无
 
otherInfo=无
 
}}{{#a:showgrade}}
 
}}{{#a:showgrade}}

2012年10月24日 (三) 14:37的版本

friendships/groups/members/ids

获取当前登录用户某一好友分组下的成员列表的ID

URL

https://api.weibo.com/2/friendships/groups/members/ids.json

支持格式

JSON

HTTP请求方式

GET

是否需要登录


关于登录授权,参见 如何登录授权

访问授权限制

访问级别:高级接口(需要授权)
频次限制:
关于频次限制,参见 接口访问权限说明

请求参数

  必选 类型及范围 说明
access_token true string 采用OAuth授权方式为必填参数,OAuth授权后获得。
list_id true int64 好友分组ID,建议使用返回值里的idstr。
count false int 单页返回的记录条数,默认为50,最大不超过200。
cursor false int 分页返回结果的游标,下一页用返回值里的next_cursor,上一页用previous_cursor,默认为0。

注意事项

调用样例及调试工具

API测试工具

返回结果

JSON示例

{
    "users": [
        185379589,
        187271210,
        164201729,
        270053774,
        223557223,
        ...
    ],
    "next_cursor": 5,
    "previous_cursor": 0,
    "total_number": 41
}

关于错误返回值与错误代码,参见 错误代码说明

返回字段说明

其他

相关问题

{{{relat_qa}}}


帮助中心 查看更多问题或提问


Language: [[{{{2/uri}}}|中文]]




api评价