friendships/groups/show_batch
批量获取好友分组的详细信息
URL
https://api.weibo.com/2/friendships/groups/show_batch.json
支持格式
JSON
HTTP请求方式
GET
是否需要登录
是
关于登录授权,参见 如何登录授权
访问授权限制
访问级别:高级接口(需要授权)
频次限制:是
关于频次限制,参见 接口访问权限说明
请求参数
必选 | 类型及范围 | 说明 | |
---|---|---|---|
access_token | true | string | 采用OAuth授权方式为必填参数,OAuth授权后获得。 |
list_ids | true | int64 | 需要查询的好友分组ID,建议使用返回值里的idstr,多个之间用逗号分隔,每次不超过20个。 |
uids | true | string | 参数list_ids所指的好友分组的所有者UID,多个之间用逗号分隔,每次不超过20个,需与list_ids一一对应。 |
注意事项
- 参数list_ids、uids,批量时用逗号分隔,且必须一一对应,uid为list_id的所有者;
- 当要查询的分组为私有分组时,当前登录用户必须为分组的所有者;
- 当前登录用户不是指定好友分组的所有者时,只能获取所有人可见的公开分组、和组内成员可见的公开分组(此时当前登录用户必须是组内成员)的分组信息;
调用样例及调试工具
返回结果
JSON示例
{ "lists": [ { "id": 3404979794629010, "idstr": "3404979794629010", "name": "同事", "mode": "private", "visible": 0, "like_count": 0, "member_count": 0, "description": "", "tags": [], "profile_image_url": "http://tp1.sinaimg.cn/1404376560/50/5629870687/1", "user": { "id": 1404376560, "idstr": "1404376560", "screen_name": "zaku", "name": "zaku", "province": "11", "city": "5", "location": "北京 朝阳区", "description": "微博开放平台产品。人生五十年,乃如梦如幻;有生斯有死,壮士复何憾。", "url": "http://blog.sina.com.cn/zaku", "profile_image_url": "http://tp1.sinaimg.cn/1404376560/50/5629870687/1", "profile_url": "zaku", "domain": "zaku", "weihao": "", "gender": "m", "followers_count": 1440, "friends_count": 604, "statuses_count": 3543, "favourites_count": 14, "created_at": "Fri Aug 28 00:00:00 +0800 2009", "following": false, "allow_all_act_msg": false, "geo_enabled": true, "verified": false, "verified_type": -1, "status_id": 3453143964431400, "allow_all_comment": true, "avatar_large": "http://tp1.sinaimg.cn/1404376560/180/5629870687/1", "verified_reason": "", "follow_me": false, "online_status": 0, "bi_followers_count": 286, "lang": "zh-cn" }, "created_at": "Mon Jan 23 12:45:05 +0800 2012" }, ... ], "total_number": 6 }
关于错误返回值与错误代码,参见 错误代码说明
返回字段说明
无
其他
无
相关问题
{{{relat_qa}}}
到 帮助中心 查看更多问题或提问