跳到主要内容

获取群组详情​

简要描述​

  • 获取指定群组的详细信息，包括群名称、群人数等

请求方式​

  • 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错误详细信息