Weibo Platform Logo

微博开放平台

weibo
跳转到： 导航, 搜索
第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=
第16行： 第15行：
 
     "users": [
 
     "users": [
 
         {
 
         {
−
             "id": 1404376560,
+
             "id": 185379589,
−
             "screen_name": "zaku",
+
            "idstr": "185379589",
−
             "name": "zaku",
+
             "screen_name": "张三",
−
             "province": "11",
+
             "name": "张三",
−
             "city": "5",
+
             "province": "44",
−
             "location": "北京 朝阳区",
+
             "city": "3",
−
             "description": "人生五十年，乃如梦如幻；有生斯有死，壮士复何憾。",
+
             "location": "广东 深圳",
−
             "url": "http://blog.sina.com.cn/zaku",
+
             "description": "IT一族",
−
             "profile_image_url": "http://tp1.sinaimg.cn/1404376560/50/0/1",
+
             "url": "",
−
             "domain": "zaku",
+
            "profile_image_url": "http://tp2.sinaimg.cn/185379589/50/40004839744/1",
 +
             "cover_image": "http://ww1.sinaimg.cn/crop.0.0.980.300/6e7eae39gw1dxtvpf1z6qj.jpg",
 +
            "profile_url": "51669027",
 +
             "domain": "izuzi",
 +
            "weihao": "51669027",
 
             "gender": "m",
 
             "gender": "m",
−
             "followers_count": 1204,
+
             "followers_count": 22,
−
             "friends_count": 447,
+
             "friends_count": 52,
−
             "statuses_count": 2908,
+
             "statuses_count": 47,
−
             "favourites_count": 0,
+
             "favourites_count": 18,
−
             "created_at": "Fri Aug 28 00:00:00 +0800 2009",
+
             "created_at": "Wed Nov 10 14:47:21 +0800 2010",
 
             "following": false,
 
             "following": false,
 
             "allow_all_act_msg": false,
 
             "allow_all_act_msg": false,
−
            "remark": "",
 
 
             "geo_enabled": true,
 
             "geo_enabled": true,
 
             "verified": false,
 
             "verified": false,
−
             "status": {
+
             "verified_type": 220,
−
                "created_at": "Tue May 24 18:04:53 +0800 2011",
+
            "remark": "",
−
                "id": 11142488790,
+
            "status_id": 3504633219606023,
−
                "text": "我的相机到了。",
+
             "allow_all_comment": false,
−
                "source": "<a href="http://weibo.com" rel="nofollow">新浪微博</a>",
+
             "avatar_large": "http://tp2.sinaimg.cn/185379589/180/40004839744/1",
−
                "favorited": false,
+
−
                "truncated": false,
+
−
                "in_reply_to_status_id": "",
+
−
                "in_reply_to_user_id": "",
+
−
                "in_reply_to_screen_name": "",
+
−
                "geo": null,
+
−
                "mid": "5610221544300749636",
+
−
                "annotations": [],
+
−
                "reposts_count": 5,
+
−
                "comments_count": 8
+
−
            },
+
−
             "allow_all_comment": true,
+
−
             "avatar_large": "http://tp1.sinaimg.cn/1404376560/180/0/1",
+
 
             "verified_reason": "",
 
             "verified_reason": "",
 
             "follow_me": false,
 
             "follow_me": false,
 
             "online_status": 0,
 
             "online_status": 0,
−
             "bi_followers_count": 215
+
             "bi_followers_count": 22,
−
         },
+
            "lang": "zh-cn"
−
        ...
+
         }
 
     ],
 
     ],
−
     "next_cursor": 5,
+
     "next_cursor": 1,
 
     "previous_cursor": 0,
 
     "previous_cursor": 0,
−
     "total_number": 668
+
     "total_number": 41
 
}
 
}
 
</pre>|
 
</pre>|
 
resultDes={{Rdes_user}}|
 
resultDes={{Rdes_user}}|
−
useAge=
+
useAge=无
−
*当要查询的分组为私有分组时，当前登录用户必须为分组的所有者；
+
|
−
*当前登录用户不是指定好友分组的所有者时，只能获取所有人可见的公开分组、和组内成员可见的公开分组（此时当前登录用户必须是组内成员）的分组成员；
+
−
*最多返回最新300位成员；|
+
 
otherInfo=无
 
otherInfo=无
 
}}{{#a:showgrade}}
 
}}{{#a:showgrade}}

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

friendships/groups/members

获取某一好友分组下的成员列表

URL

https://api.weibo.com/2/friendships/groups/members.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": [
        {
            "id": 185379589,
            "idstr": "185379589",
            "screen_name": "张三",
            "name": "张三",
            "province": "44",
            "city": "3",
            "location": "广东 深圳",
            "description": "IT一族",
            "url": "",
            "profile_image_url": "http://tp2.sinaimg.cn/185379589/50/40004839744/1",
            "cover_image": "http://ww1.sinaimg.cn/crop.0.0.980.300/6e7eae39gw1dxtvpf1z6qj.jpg",
            "profile_url": "51669027",
            "domain": "izuzi",
            "weihao": "51669027",
            "gender": "m",
            "followers_count": 22,
            "friends_count": 52,
            "statuses_count": 47,
            "favourites_count": 18,
            "created_at": "Wed Nov 10 14:47:21 +0800 2010",
            "following": false,
            "allow_all_act_msg": false,
            "geo_enabled": true,
            "verified": false,
            "verified_type": 220,
            "remark": "",
            "status_id": 3504633219606023,
            "allow_all_comment": false,
            "avatar_large": "http://tp2.sinaimg.cn/185379589/180/40004839744/1",
            "verified_reason": "",
            "follow_me": false,
            "online_status": 0,
            "bi_followers_count": 22,
            "lang": "zh-cn"
        }
    ],
    "next_cursor": 1,
    "previous_cursor": 0,
    "total_number": 41
}

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

返回字段说明

返回值字段 字段类型 字段说明
id int64 用户UID
idstr string 字符串型的用户UID
screen_name string 用户昵称
name string 友好显示名称
province int 用户所在省级ID
city int 用户所在城市ID
location string 用户所在地
description string 用户个人描述
url string 用户博客地址
profile_image_url string 用户头像地址（中图），50×50像素
profile_url string 用户的微博统一URL地址
domain string 用户的个性化域名
weihao string 用户的微号
gender string 性别，m：男、f：女、n：未知
followers_count int 粉丝数
friends_count int 关注数
statuses_count int 微博数
favourites_count int 收藏数
created_at string 用户创建（注册）时间
following boolean 暂未支持
allow_all_act_msg boolean 是否允许所有人给我发私信，true：是，false：否
geo_enabled boolean 是否允许标识用户的地理位置，true：是，false：否
verified boolean 是否是微博认证用户，即加V用户，true：是，false：否
verified_type int 暂未支持
remark string 用户备注信息，只有在查询用户关系时才返回此字段
status object 用户的最近一条微博信息字段 详细
allow_all_comment boolean 是否允许所有人对我的微博进行评论，true：是，false：否
avatar_large string 用户头像地址（大图），180×180像素
avatar_hd string 用户头像地址（高清），高清头像原图
verified_reason string 认证原因
follow_me boolean 该用户是否关注当前登录用户，true：是，false：否
online_status int 用户的在线状态，0：不在线、1：在线
bi_followers_count int 用户的互粉数
lang string 用户当前的语言版本，zh-cn：简体中文，zh-tw：繁体中文，en：英语

其他

无

相关问题

{{{relat_qa}}}


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


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




来自“http://open.weibo.com/wiki/index.php?title=2/friendships/groups/members&oldid=9654”

关于微博开放平台| 联系我们| 服务条款| 无线游戏| 开放平台官微

京网文 [2011] 0398-130号 京ICP证100780号 Copyright © 1996-2024 SINA

api评价