跳转到: 导航, 搜索
第1行: 第1行:
 
{{api_desc_v2|
 
{{api_desc_v2|
 
uri=friendships/groups/members/description|
 
uri=friendships/groups/members/description|
desc=批量取好友分组成员的分组说明|
+
desc=批量获取当前登录用户好友分组成员的分组说明|
 
httpMethod=GET|
 
httpMethod=GET|
 
needAuth=是|
 
needAuth=是|
第8行: 第8行:
 
params=
 
params=
 
{{api_args|uids|true|string|需要查询的好友分组成员用户UID,多个之间用逗号分隔,最多不超过100个。}}
 
{{api_args|uids|true|string|需要查询的好友分组成员用户UID,多个之间用逗号分隔,最多不超过100个。}}
{{api_args|list_id|true|int64|指定成员所在的好友分组ID,建议使用返回值里的idstr。}}|
+
{{api_args|list_id|true|int64|指定成员所在的好友分组ID,建议使用返回值里的idstr。}}
 +
|
 
result=
 
result=
 
<pre>
 
<pre>
第14行: 第15行:
 
     "group_descriptions": [
 
     "group_descriptions": [
 
         {
 
         {
             "uid": "1769092983",
+
             "uid": "176909298",
 
             "group_description": "分组说明1"
 
             "group_description": "分组说明1"
 
         },
 
         },
 
         {
 
         {
             "uid": "1859280810",
+
             "uid": "185928081",
 
             "group_description": "分组说明2"
 
             "group_description": "分组说明2"
 
         },
 
         },
 
         ...
 
         ...
 
     ],
 
     ],
     "list_id": 20111123049957500
+
     "list_id": 2011112304995750
 
}
 
}
 
</pre>|
 
</pre>|
 
resultDes=无|
 
resultDes=无|
 
useAge=
 
useAge=
*当要查询的分组为私有分组时,当前登录用户必须为分组的所有者;
+
*当前登录用户不是指定好友分组的所有者时,只能获取所有人可见的公开分组、和组内成员可见的公开分组(此时当前登录用户必须是组内成员)的分组成员信息;|
+
|
 
otherInfo=无
 
otherInfo=无
 
}}{{#a:showgrade}}
 
}}{{#a:showgrade}}

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

friendships/groups/members/description

批量获取当前登录用户好友分组成员的分组说明

URL

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

支持格式

JSON

HTTP请求方式

GET

是否需要登录


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

访问授权限制

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

请求参数

  必选 类型及范围 说明
access_token true string 采用OAuth授权方式为必填参数,OAuth授权后获得。
uids true string 需要查询的好友分组成员用户UID,多个之间用逗号分隔,最多不超过100个。
list_id true int64 指定成员所在的好友分组ID,建议使用返回值里的idstr。

注意事项

调用样例及调试工具

API测试工具

返回结果

JSON示例

{
    "group_descriptions": [
        {
            "uid": "176909298",
            "group_description": "分组说明1"
        },
        {
            "uid": "185928081",
            "group_description": "分组说明2"
        },
        ...
    ],
    "list_id": 2011112304995750
}

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

返回字段说明

其他

相关问题

{{{relat_qa}}}


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


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




api评价