Files
EchoChat/docs/api/admin/meeting.md
bujinyuan 7dcd89c7fc docs: API 文档按端+模块二级目录重组
- 前台用户端 API 迁移到 frontend/ 目录(auth/contact/im/meeting/notify)
- 后台管理端 admin.md 拆分为 admin/ 目录下 4 个文档(auth/user/meeting/system)
- WebSocket 协议保留在根目录(跨端通用)
- 更新 README 导航为两级结构,补充目录结构说明
- 更新所有文档间的交叉引用路径

Made-with: Cursor
2026-02-28 09:52:52 +08:00

2.1 KiB
Raw Blame History

管理端 — 会议管理 API

通用规范(认证方式、响应格式、错误码)见 README.md 以下所有接口均需要 JWT 认证 + admin/super_admin 角色


接口列表

方法 路径 权限 说明
GET /api/v1/admin/meetings admin 获取会议列表
GET /api/v1/admin/meetings/:id admin 获取会议详情
PUT /api/v1/admin/meetings/:id/close admin 强制结束会议
GET /api/v1/admin/meetings/stats admin 获取会议统计

1. 获取会议列表

GET /api/v1/admin/meetings

权限: admin

查询参数:

参数 类型 默认值 说明
status int 按状态筛选0=未开始1=进行中2=已结束
type int 按类型筛选1=即时会议2=预约会议
keyword string 搜索关键词(匹配会议标题)
page int 1 页码
page_size int 20 每页数量

2. 获取会议详情

GET /api/v1/admin/meetings/:id

权限: admin

说明: 返回会议完整信息,包括参与者列表、会议设置、时长统计等。


3. 强制结束会议

PUT /api/v1/admin/meetings/:id/close

权限: admin

说明: 强制结束后,所有参会者将收到会议结束通知,所有媒体资源将被回收。操作将记录到管理日志(admin_operation_logs 表)。


4. 获取会议统计

GET /api/v1/admin/meetings/stats

权限: admin

成功响应:

{
    "code": 0,
    "message": "ok",
    "data": {
        "total_meetings": 1500,
        "ongoing_meetings": 5,
        "today_meetings": 23,
        "total_participants": 8500,
        "avg_duration": 1800
    }
}

字段说明:

字段 类型 说明
total_meetings int 历史会议总数
ongoing_meetings int 当前进行中的会议数
today_meetings int 今日创建的会议数
total_participants int 历史累计参会人次
avg_duration int 平均会议时长(秒)