跳转到: 导航, 搜索
(以“{{api_desc_v2| uri=friendships/groups/show| desc=获取某个分组的详细信息| httpMethod=GET| needAuth=是| level={{Api_L2}}| rateLimit=是| params= {{api_args...”为内容创建页面)
 
第1行: 第1行:
 
{{api_desc_v2|
 
{{api_desc_v2|
 
uri=friendships/groups/show|
 
uri=friendships/groups/show|
desc=获取某个分组的详细信息|
+
desc=获取当前登陆用户某个分组的详细信息|
 
httpMethod=GET|
 
httpMethod=GET|
 
needAuth=是|
 
needAuth=是|
第7行: 第7行:
 
rateLimit=是|
 
rateLimit=是|
 
params=
 
params=
{{api_args|list_id|true|int64|需要查询的好友分组ID,建议使用返回值里的idstr。}}|
+
{{api_args|list_id|true|int64|需要查询的好友分组ID,建议使用返回值里的idstr。}}
 +
|
 
result=
 
result=
 
<pre>
 
<pre>
 
{
 
{
     "id": 3404979794629010,
+
     "id": 2210122500120063000,
     "idstr": "3404979794629010",
+
     "idstr": "2210122500120063000",
     "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/24767762900/50/5619144918/1",
 
     "user": {
 
     "user": {
         "id": 1404376560,
+
         "id": 19025380500,
         "idstr": "1404376560",
+
         "idstr": "19025380500",
         "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/19025380500/50/22817372040/1",
         "profile_url": "zaku",
+
         "profile_url": "304270168",
         "domain": "zaku",
+
         "domain": "zhangsan123",
         "weihao": "",
+
         "weihao": "3042701600",
 
         "gender": "m",
 
         "gender": "m",
         "followers_count": 1440,
+
         "followers_count": 337,
         "friends_count": 604,
+
         "friends_count": 534,
         "statuses_count": 3543,
+
         "statuses_count": 516,
         "favourites_count": 14,
+
         "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": 3453143964431400,
+
 
         "allow_all_comment": true,
 
         "allow_all_comment": true,
         "avatar_large": "http://tp1.sinaimg.cn/1404376560/180/5629870687/1",
+
         "avatar_large": "http://tp2.sinaimg.cn/19025380500/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"
 
}
 
}
 
</pre>|
 
</pre>|
 
resultDes=无|
 
resultDes=无|
 
useAge=
 
useAge=
*当要查询的分组为私有分组时,当前登录用户必须为分组的所有者;
+
*当前登录用户不是指定好友分组的所有者时,只能获取所有人可见的公开分组、和组内成员可见的公开分组(此时当前登录用户必须是组内成员)的分组信息;|
+
|
 
otherInfo=无
 
otherInfo=无
 
}}{{#a:showgrade}}
 
}}{{#a:showgrade}}

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

friendships/groups/show

获取当前登陆用户某个分组的详细信息

URL

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

支持格式

JSON

HTTP请求方式

GET

是否需要登录


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

访问授权限制

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

请求参数

  必选 类型及范围 说明
access_token true string 采用OAuth授权方式为必填参数,OAuth授权后获得。
list_id true int64 需要查询的好友分组ID,建议使用返回值里的idstr。

注意事项

调用样例及调试工具

API测试工具

返回结果

JSON示例

{
    "id": 2210122500120063000,
    "idstr": "2210122500120063000",
    "name": "同学",
    "mode": "private",
    "visible": 0,
    "like_count": 0,
    "member_count": 41,
    "description": "",
    "tags": [],
    "profile_image_url": "http://tp3.sinaimg.cn/24767762900/50/5619144918/1",
    "user": {
        "id": 19025380500,
        "idstr": "19025380500",
        "screen_name": "张三",
        "name": "张三",
        "province": "11",
        "city": "8",
        "location": "北京 海淀区",
        "description": "做最受尊敬的互联网产品经理...",
        "url": "",
        "profile_image_url": "http://tp2.sinaimg.cn/19025380500/50/22817372040/1",
        "profile_url": "304270168",
        "domain": "zhangsan123",
        "weihao": "3042701600",
        "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/19025380500/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"
}

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

返回字段说明

其他

相关问题

{{{relat_qa}}}


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


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




api评价