Эндпоинты управления комнатами находятся под /api/room/. Все эндпоинты требуют аутентификации.

Обзор

Эндпоинты

Создание комнаты

Создание новой комнаты для встреч. Авторизованный пользователь становится администратором комнаты.

POST /api/room/create

Заголовки: Authorization: Bearer <accessToken>

Тело запроса:

{
  "name": "team-standup",
  "isPublic": true,
  "mode": "standard",
  "settings": {
    "allowChat": true,
    "allowVideo": true,
    "allowAudio": true,
    "requireApproval": false,
    "e2ee": false
  }
}

Примечание: Поле name необязательно. Если оно опущено или пустое, сервер автоматически сгенерирует случайное URL-безопасное имя в формате xxx-xxxx-xxx (например, bkf-qmzl-rja).

Правила имени комнаты:

Имена комнат отображаются в URL как https://bedrud.xyz/m/NAME, поэтому они должны быть URL-безопасными:

Ответ (200):

{
  "id": "uuid",
  "name": "team-standup",
  "createdBy": "user-uuid",
  "isActive": true,
  "isPublic": true,
  "maxParticipants": 0,
  "settings": {
    "allowChat": true,
    "allowVideo": true,
    "allowAudio": true,
    "requireApproval": false,
    "e2ee": false
  },
  "livekitHost": "wss://lk.bedrud.xyz",
  "mode": "standard"
}

Поля

Присоединение к комнате

Присоединение к существующей комнате и получение LiveKit-токена для медиаподключения.

POST /api/room/join

Заголовки: Authorization: Bearer <accessToken>

Тело запроса:

{
  "roomName": "team-standup"
}

Ответ (200):

{
  "id": "uuid",
  "name": "team-standup",
  "token": "eyJ...",
  "createdBy": "user-uuid",
  "adminId": "user-uuid",
  "isActive": true,
  "isPublic": true,
  "maxParticipants": 20,
  "expiresAt": "2026-02-16T12:00:00Z",
  "settings": { ... },
  "livekitHost": "wss://lk.bedrud.xyz",
  "mode": "standard"
}

Поле token - это подписанный access-токен LiveKit. Используйте его для подключения к серверу LiveKit через WebSocket:

import { Room } from 'livekit-client';
 
const room = new Room();
await room.connect(livekitUrl, token);

Список комнат

Получение списка комнат, созданных пользователем.

GET /api/room/list

Заголовки: Authorization: Bearer <accessToken>

Ответ (200):

[
  {
    "id": "uuid",
    "name": "team-standup",
    "createdBy": "user-uuid",
    "isActive": true,
    "maxParticipants": 20,
    "expiresAt": "2026-02-16T12:00:00Z",
    "settings": { ... },
    "mode": "standard",
    "relationship": "creator"
  }
]

Исключение участника

Удаление участника из комнаты. Доступно только администратору комнаты.

POST /api/room/:roomId/kick/:identity

Заголовки: Authorization: Bearer <accessToken>

Ответ (200):

{
  "status": "success"
}

Заглушить участника

Отключение микрофона участника. Доступно только администратору комнаты.

POST /api/room/:roomId/mute/:identity

Заголовки: Authorization: Bearer <accessToken>

Ответ (200):

{
  "status": "success"
}

Отключение видео участника

Отключение камеры участника. Доступно только администратору комнаты.

POST /api/room/:roomId/video/:identity/off

Заголовки: Authorization: Bearer <accessToken>

Ответ (200):

{
  "status": "success"
}

Управление администратора

Действия администратора комнаты (исключение, заглушение, отключение видео) доступны только пользователю, создавшему комнату (adminId). Попытка выполнения этих действий не-администратором возвращает ошибку 403.

Матрица прав

Ответы об ошибках

Все ошибки возвращаются в едином формате:

{
  "error": "human-readable error message"
}

Ошибки создания комнаты

Общие ошибки

См. также

• Обзор архитектуры - модель данных и поток подключения к встрече
• Обработчики API - реализация комнатных эндпоинтов