跳到主要内容

创建群组​

简要描述​

  • 创建群组。

请求方式​

  • post

请求URL​

  • http://x.x.x.x:10002/group/create_group
header名示例值选填类型说明
operationID1646445464564必填stringoperationID用于全局链路追踪
tokeneyJhbxxxx3Xs必填string管理员token

请求参数示例​

{
  "memberUserIDs": [
    "1225441072"
  ],
  "adminUserIDs": [
    "2065939257"
  ],
  "ownerUserID": "1054527962",
  "groupInfo": {
    "groupID": "xadxwr24",
    "groupName": "yourg group name",
    "notification": "notification",
    "introduction": "introduction",
    "faceURL": "faceURL url",
    "ex": "ex",
    "groupType": 2,
    "needVerification": 0,
    "lookMemberInfo": 0,
    "applyMemberFriend": 0
  }
}
字段名选填类型说明
memberUserIDs必填array群成员列表
adminUserIDs选填array群管理员列表
ownerUserID选填string群主
groupInfo必填object群信息列表
groupInfo.groupID选填string群ID
groupInfo.groupName必填string群名称
groupInfo.notification必填string群公告
groupInfo.introduction必填string群介绍
groupInfo.faceURL必填string群头像
groupInfo.ex必填string扩展字段
groupInfo.groupType必填int群状态
groupInfo.needVerification必填int进群是否需要验证
groupInfo.lookMemberInfo必填int能否查看其他群成员信息
groupInfo.applyMemberFriend必填int群成员是否允许添加好友

成功返回示例​

{
  "errCode": 0,
  "errMsg": "",
  "errDlt": "",
  "data": {
    "groupInfo": {
      "groupID": "xadxwr24",
      "groupName": "yourg group name",
      "notification": "notification",
      "introduction": "introduction",
      "faceURL": "faceURL url",
      "ownerUserID": "199975690",
      "createTime": 1679656402377,
      "memberCount": 4,
      "ex": "ex",
      "status": 0,
      "creatorUserID": "",
      "groupType": 2,
      "needVerification": 0,
      "lookMemberInfo": 0,
      "applyMemberFriend": 0,
      "notificationUpdateTime": 0,
      "notificationUserID": ""
    }
  }
}

成功返回示例的参数说明​

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

失败返回示例​

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

失败返回示例的参数说明​

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