查询一个或多个高级群的群组信息和相应的群成员列表。

查询群成员会使查询时间增加，所以如果您不需要查询群成员列表，建议您只查询群组信息。

使用限制

单个应用中，一秒内所有的高级群操作 API 合计最多可调用 100 次，超过后限制调用，会返回调用频率超出限制的 416 错误码。除 发送群消息 API 外，其他所有高级群相关 API，都遵从频率限制。

请求信息

请求 URL

HTTPPOST https://api.yunxinapi.com/nimserver/team/query.action HTTP/1.1
Content-Type: application/x-www-form-urlencoded;charset=utf-8

请求头参数

请参考 API 调用方式。

请求体参数

参数	类型	必填	说明
tids	String	是	群 ID 列表，如["3083","3084"]，一次最多查询 10 个群，最大长度 1024 位字符
ope	Integer	是	1，表示带上群成员列表。0，表示不带群成员列表，只返回群信息

请求示例（cURL）

cURLcurl -X POST -H "AppKey: go9dnk49b **w0803mgq3" -H "Nonce: 4tggger** 323t23t" -H "CurTime: 1443592222" -H "CheckSum: 9e9db3b6c9abb2e1962cf3e6f7316fcc55583f86" -H "Content-Type: application/x-www-form-urlencoded" -d 'tids=%5B%223083%22%2C%223084%22%5D&ope=1' 'https://api.yunxinapi.com/nimserver/team/query.action'

响应信息

响应体参数

参数	类型	说明
code	Integer	状态码
- tinfos	JSON Array	群组信息
tname	String	群名称
icon	String	群头像
owner	String	群主用户账号
maxusers	Integer	群成员最大数量
tid	Long	群 ID
size	Integer	当前群成员数量
announcement	String	群公告
intro	String	群介绍
joinmode	Integer	申请入群的验证方式 0，不用验证。1，需要验证。2，不允许任何人加入
beinvitemode	Integer	群创建完成后，邀请入群时是否需要被邀请人的同意 0，需要同意（默认）。1，不需要同意
invitemode	Integer	邀请权限，即谁可以邀请他人入群 0，群主和管理员（默认）。1，所有人
uptinfomode	Integer	客户端修改群信息权限，即谁可以修改群信息 0，群主和管理员（默认）。1，所有人
upcustommode	Integer	客户端修改群自定义属性权限，即谁可以修改群自定义属性 0，群主和管理员（默认）。1，所有人
muteType	Integer	群禁言类型 0，解除禁言。1，禁言普通成员。3，禁言整个群（包括群主）
isNotifyCloseOnline	Boolean	群通知消息是否关闭在线发送（开启该功能才会有该字段）
isNotifyClosePersistent	Boolean	群通知消息是否关闭持久化存储（开启该功能才会有该字段）
custom	String	自定义高级群扩展属性
clientCustom	String	客户端自定义字段
mute	Boolean	是否全员禁言
admins	List<String>	管理员账号
members	List<String>	群成员列表
createtime	Long	创建时间
updatetime	Long	更新时间

成功响应示例

JSON"Content-Type": "application/json; charset=utf-8"
//查询不带群成员的群列表信息
{
    "code": 200,
    "tinfos": [
        {
            "tname": "aa",
            "announcement": "aa",
            "owner": "v4",
            "maxusers": 50,
            "joinmode": 1,
            "tid": 3083,
            "intro": "test",
            "size": 3,
            "custom": "",
            "clientCustom": "",
            "mute": true,
            "createtime": 1506652312445,
            "updatetime": 1521082125400
        },
        {
            "tname": "bb",
            "announcement": "bb",
            "owner": "v4",
            "maxusers": 50,
            "joinmode": 1,
            "tid": 3084,
            "intro": "test",
            "size": 3,
            "custom": "",
            "clientCustom": "",
            "mute": false,
            "createtime": 1506652312445,
            "updatetime": 1521082125400
        }
    ]
}

//查询带群成员的群列表信息
{
    "code": 200,
    "tinfos": [
        {
            "tname": "aa",
            "announcement": "aa",
            "owner": "v4",
            "maxusers": 50,
            "joinmode": 1,
            "tid": 3083,
            "intro": "test",
            "size": 3,
            "custom": "",
            "mute": true,
            "createtime": 1506652312445,
            "updatetime": 1521082125400,
            "admins": ["v1"],
            "members": ["v1", "v2"]
        },
        {
            "tname": "bb",
            "announcement": "bb",
            "owner": "v4",
            "maxusers": 50,
            "joinmode": 1,
            "tid": 3084,
            "intro": "test",
            "size": 3,
            "custom": "",
            "mute": false,
            "createtime": 1506652312445,
            "updatetime": 1521082125400,
            "admins": ["v1"],
            "members": ["v1", "v2"]
        }
    ] // admins 表示是管理员
}

失败响应示例

JSON"Content-Type": "application/json; charset=utf-8"
{
"code": 414, // 参数错误
"desc": "xxxx is empty"
}

状态码

该接口在 HTTPS Body 中返回请求的状态码，以下仅列出与接口业务相关的状态码。完整状态码请参考 状态码。

状态码	说明	处理建议
200	请求成功	-
403	禁止操作： 非高级群不支持该操作	根据对应提示信息做出处理
414	参数错误	根据提示信息，检查传入参数的格式和限制条件
416	调用频率超出限制	降低访问频率
500	服务出错	-