跳到主要内容

获取群组信息

简要描述

  • 获取指定群组的详细信息。

请求方式

  • post

请求URL

  • {API_ADDRESS}/group/get_groups_info
header名示例值选填类型说明
operationID1646445464564必填string用于全局链路追踪,建议使用时间戳,在每个请求中独立
tokeneyJhbxxxx3Xs必填string管理员 token

请求参数示例

{
"groupIDs": ["2137448827", "2559217223"]
}
字段名选填类型说明
groupIDs必填array群ID列表

成功返回示例

{
"errCode": 0,
"errMsg": "",
"errDlt": "",
"data": {
"groupInfos": [
{
"groupID": "2559217223",
"groupName": "Group1",
"notification": "",
"introduction": "",
"faceURL": "",
"ownerUserID": "4771680259",
"createTime": 1687760824104,
"memberCount": 5,
"ex": "",
"status": 0,
"creatorUserID": "4771680259",
"groupType": 2,
"needVerification": 0,
"lookMemberInfo": 0,
"applyMemberFriend": 0,
"notificationUpdateTime": 0,
"notificationUserID": ""
},
{
"groupID": "2137448827",
"groupName": "11111",
"notification": "",
"introduction": "",
"faceURL": "",
"ownerUserID": "3517105008",
"createTime": 1687753739612,
"memberCount": 3,
"ex": "",
"status": 0,
"creatorUserID": "2699373280",
"groupType": 2,
"needVerification": 0,
"lookMemberInfo": 0,
"applyMemberFriend": 0,
"notificationUpdateTime": 0,
"notificationUserID": ""
}
]
}
}

成功返回示例的参数说明

参数名类型说明
errCodeint错误码,0表示成功
errMsgstring错误简要信息,为空
errDlterrDlt错误详细信息,为空
dataobject通用数据对象,具体结构见下方
groupInfosarray群信息列表

失败返回示例

{
"errCode": 1004,
"errMsg": "RecordNotFoundError",
"errDlt": ": [1004]RecordNotFoundError"
}

失败返回示例的参数说明

参数名类型说明
errCodeint错误码,具体查看全局错误码文档
errMsgstring错误简要信息
errDlterrDlt错误详细信息