Weibo Platform Logo

微博开放平台

weibo
跳转到： 导航, 搜索
第6行： 第6行：
 
level={{Api_L2}}|
 
level={{Api_L2}}|
 
rateLimit=是|
 
rateLimit=是|
−
params=
+
params=|
−
{{api_args|uid|false|int64|需要查询的指定用户UID，如果指定的UID不是当前登录用户，则只能获取到对方设置为可见的公开分组，默认不填为当前登录用户。}}
+
−
{{api_args|mode|false|string|返回的好友分组类型，all：当前登录用户可见的分组、public：公开分组、private：私有分组，默认为all。}}|
+
 
result=
 
result=
 
<pre>
 
<pre>
第14行： 第12行：
 
     "lists": [
 
     "lists": [
 
         {
 
         {
−
             "id": 3404979794629010,
+
             "id": 221012250012006340,
−
             "idstr": "3404979794629010",
+
             "idstr": "221012250012006330",
−
             "name": "同事",
+
             "name": "同学",
 
             "mode": "private",
 
             "mode": "private",
 
             "visible": 0,
 
             "visible": 0,
 
             "like_count": 0,
 
             "like_count": 0,
−
             "member_count": 0,
+
             "member_count": 41,
 
             "description": "",
 
             "description": "",
 
             "tags": [],
 
             "tags": [],
−
             "profile_image_url": "http://tp1.sinaimg.cn/1404376560/50/5629870687/1",
+
             "profile_image_url": "http://tp3.sinaimg.cn/2476776294/50/5619144918/1",
 
             "user": {
 
             "user": {
−
                 "id": 1404376560,
+
                 "id": 1902538057,
−
                 "idstr": "1404376560",
+
                 "idstr": "1902538057",
−
                 "screen_name": "zaku",
+
                 "screen_name": "张三",
−
                 "name": "zaku",
+
                 "name": "张三",
 
                 "province": "11",
 
                 "province": "11",
−
                 "city": "5",
+
                 "city": "8",
−
                 "location": "北京 朝阳区",
+
                 "location": "北京 海淀区",
−
                 "description": "微博开放平台产品。人生五十年，乃如梦如幻；有生斯有死，壮士复何憾。",
+
                 "description": "做最受尊敬的互联网产品经理...",
−
                 "url": "http://blog.sina.com.cn/zaku",
+
                 "url": "",
−
                 "profile_image_url": "http://tp1.sinaimg.cn/1404376560/50/5629870687/1",
+
                 "profile_image_url": "http://tp2.sinaimg.cn/1902538057/50/22817372040/1",
−
                 "profile_url": "zaku",
+
                 "profile_url": "304270168",
−
                 "domain": "zaku",
+
                 "domain": "shenbinzhu",
−
                 "weihao": "",
+
                 "weihao": "304270168",
 
                 "gender": "m",
 
                 "gender": "m",
−
                 "followers_count": 1441,
+
                 "followers_count": 337,
−
                 "friends_count": 601,
+
                 "friends_count": 534,
−
                 "statuses_count": 3534,
+
                 "statuses_count": 516,
−
                 "favourites_count": 13,
+
                 "favourites_count": 60,
−
                 "created_at": "Fri Aug 28 00:00:00 +0800 2009",
+
                 "created_at": "Sat Dec 25 14:12:35 +0800 2010",
 
                 "following": false,
 
                 "following": false,
−
                 "allow_all_act_msg": false,
+
                 "allow_all_act_msg": true,
 
                 "geo_enabled": true,
 
                 "geo_enabled": true,
 
                 "verified": false,
 
                 "verified": false,
−
                 "verified_type": -1,
+
                 "verified_type": 220,
−
                "status_id": 3451328979913246,
+
 
                 "allow_all_comment": true,
 
                 "allow_all_comment": true,
−
                 "avatar_large": "http://tp1.sinaimg.cn/1404376560/180/5629870687/1",
+
                 "avatar_large": "http://tp2.sinaimg.cn/1902538057/180/22817372040/1",
 
                 "verified_reason": "",
 
                 "verified_reason": "",
 
                 "follow_me": false,
 
                 "follow_me": false,
 
                 "online_status": 0,
 
                 "online_status": 0,
−
                 "bi_followers_count": 286,
+
                 "bi_followers_count": 185,
 
                 "lang": "zh-cn"
 
                 "lang": "zh-cn"
 
             },
 
             },
−
             "created_at": "Mon Jan 23 12:45:05 +0800 2012"
+
             "created_at": "Sat Dec 25 14:12:35 +0800 2010"
 
         },
 
         },
 
         ...
 
         ...
 
     ],
 
     ],
−
     "total_number": 6
+
     "total_number": 13
 
}
 
}
 
</pre>|
 
</pre>|
 
resultDes=无|
 
resultDes=无|
 
useAge=
 
useAge=
−
*只有查询的指定用户是当前登录用户时，才能获取到私有分组（private）的数据；
 
 
*返回的数据按设置的分组顺序排序；
 
*返回的数据按设置的分组顺序排序；
 
*好友分组上限为20，“未分组”不计入上限；
 
*好友分组上限为20，“未分组”不计入上限；
−
*"未分组"的分组ID为0；|
+
*"未分组"的分组ID为0，此接口不返回“未分组”；|
 
otherInfo=无
 
otherInfo=无
 
}}{{#a:showgrade}}
 
}}{{#a:showgrade}}

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

friendships/groups

获取指定用户的好友分组列表

URL

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

支持格式

JSON

HTTP请求方式

GET

是否需要登录

是
关于登录授权，参见 如何登录授权

访问授权限制

访问级别：高级接口（需要授权）
频次限制：是
关于频次限制，参见 接口访问权限说明

请求参数

  必选 类型及范围 说明
access_token true string 采用OAuth授权方式为必填参数，OAuth授权后获得。

注意事项

  • 返回的数据按设置的分组顺序排序；
  • 好友分组上限为20，“未分组”不计入上限；
  • "未分组"的分组ID为0，此接口不返回“未分组”；

调用样例及调试工具

API测试工具

返回结果

JSON示例

{
    "lists": [
        {
            "id": 221012250012006340,
            "idstr": "221012250012006330",
            "name": "同学",
            "mode": "private",
            "visible": 0,
            "like_count": 0,
            "member_count": 41,
            "description": "",
            "tags": [],
            "profile_image_url": "http://tp3.sinaimg.cn/2476776294/50/5619144918/1",
            "user": {
                "id": 1902538057,
                "idstr": "1902538057",
                "screen_name": "张三",
                "name": "张三",
                "province": "11",
                "city": "8",
                "location": "北京 海淀区",
                "description": "做最受尊敬的互联网产品经理...",
                "url": "",
                "profile_image_url": "http://tp2.sinaimg.cn/1902538057/50/22817372040/1",
                "profile_url": "304270168",
                "domain": "shenbinzhu",
                "weihao": "304270168",
                "gender": "m",
                "followers_count": 337,
                "friends_count": 534,
                "statuses_count": 516,
                "favourites_count": 60,
                "created_at": "Sat Dec 25 14:12:35 +0800 2010",
                "following": false,
                "allow_all_act_msg": true,
                "geo_enabled": true,
                "verified": false,
                "verified_type": 220,
                "allow_all_comment": true,
                "avatar_large": "http://tp2.sinaimg.cn/1902538057/180/22817372040/1",
                "verified_reason": "",
                "follow_me": false,
                "online_status": 0,
                "bi_followers_count": 185,
                "lang": "zh-cn"
            },
            "created_at": "Sat Dec 25 14:12:35 +0800 2010"
        },
        ...
    ],
    "total_number": 13
}

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

返回字段说明

无

其他

无

相关问题

{{{relat_qa}}}


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


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




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

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

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

api评价