创建群组 - 齐成云·IM消息服务

创建新群组，可设置群名、头像、描述等基本信息，并邀请初始成员

请求参数

Header 参数

Authorization

string

可选

默认值:

Bearer QC2b8fd0ca342c72f857f5f96

Appid

string

可选

默认值:

1001

ClientId

string

可选

默认值:

131231231223

TimeStamp

string

可选

默认值:

Client-Type

string

可选

默认值:

EnterpriseCenterWEB

Body 参数application/json

groupName

string

群组名称

必需

>= 1 字符<= 100 字符

示例值:

技术交流群

groupAvatar

string

群头像URL

可选

<= 255 字符

示例值:

https://example.com/avatar.jpg

groupDescription

string

群描述

可选

<= 500 字符

示例值:

这是一个技术交流群，欢迎大家分享学习心得

groupType

enum<string>

群类型

可选

枚举值:

normalofficial

示例值:

normal

initialMembers

array[string]

可选

初始成员用户ID列表

示例值:

["user_123","user_456"]

示例

{
    "groupName": "技术交流群",
    "groupAvatar": "https://example.com/avatar.jpg",
    "groupDescription": "这是一个技术交流群，欢迎大家分享学习心得",
    "groupType": "normal",
    "initialMembers": [
        "user_123",
        "user_456"
    ]
}

返回响应

🟢200成功

application/json

创建成功

Body

object {0}

示例

{
    "code": 1,
    "message": "群组创建成功",
    "data": {
        "group_id": "g_Ab3Xy9Mn4Kp8",
        "group_code": "1234567890",
        "group_name": "技术交流群",
        "group_avatar": "https://example.com/avatar.jpg",
        "group_description": "这是一个技术交流群，欢迎大家分享学习心得",
        "group_type": "normal",
        "group_owner_id": "user_owner",
        "group_status": "active",
        "created_at": "2024-01-01T12:00:00Z"
    }
}

🟠400请求有误