Los endpoints de gestión de salas están bajo /api/room/. Todos los endpoints requieren autenticación.

Resumen

Endpoints

Crear Sala

Crea una nueva sala de reunión. El usuario autenticado se convierte en el administrador de la sala.

POST /api/room/create

Encabezados: Authorization: Bearer <accessToken>

Cuerpo de la Solicitud:

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

Nota: El campo name es opcional. Si se omite o está vacío, el servidor generará automáticamente un nombre seguro para URL aleatorio en el formato xxx-xxxx-xxx (ej. bkf-qmzl-rja).

Reglas de Nombres de Sala:

Los nombres de sala aparecen en la URL como https://bedrud.xyz/m/NAME, por lo que deben ser seguros para URL:

Respuesta (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"
}

Campos

Unirse a Sala

Únete a una sala existente y recibe un token de LiveKit para la conexión multimedia.

POST /api/room/join

Encabezados: Authorization: Bearer <accessToken>

Cuerpo de la Solicitud:

{
  "roomName": "team-standup"
}

Respuesta (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"
}

El token es un token de acceso firmado de LiveKit. Úsalo para conectarte al servidor de LiveKit a través de WebSocket:

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

Listar Salas

Obtén una lista de salas que el usuario ha creado.

GET /api/room/list

Encabezados: Authorization: Bearer <accessToken>

Respuesta (200):

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

Expulsar Participante

Elimina a un participante de la sala. Solo el administrador de la sala puede hacer esto.

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

Encabezados: Authorization: Bearer <accessToken>

Respuesta (200):

{
  "status": "success"
}

Silenciar Participante

Silencia el micrófono de un participante. Solo el administrador de la sala puede hacer esto.

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

Encabezados: Authorization: Bearer <accessToken>

Respuesta (200):

{
  "status": "success"
}

Desactivar Video de Participante

Apaga la cámara de un participante. Solo el administrador de la sala puede hacer esto.

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

Encabezados: Authorization: Bearer <accessToken>

Respuesta (200):

{
  "status": "success"
}

Controles de Administrador

Las acciones de administrador de sala (expulsar, silenciar, apagar video) solo están disponibles para el usuario que creó la sala (adminId). Intentar estas acciones como no administrador devuelve un error 403.

Matriz de Permisos

Respuestas de Error

Todos los errores siguen un formato consistente:

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

Errores de Crear Sala

Errores Generales

Véase también

• Resumen de Arquitectura - modelo de datos y flujo de conexión de reunión
• Handlers de API - cómo se implementan los endpoints de salas