跳到主要内容

创建群组

简要描述

  • 创建群组。

请求方式

  • post

请求URL

  • {API_ADDRESS}/group/create_group
header名示例值选填类型说明
operationID1646445464564必填string用于全局链路追踪,建议使用时间戳,在每个请求中独立
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群类型,固定为2。
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错误详细信息