Les points de terminaison de gestion des salles sont sous /api/room/. Tous les points de terminaison nécessitent une authentification.

Vue d’ensemble

Points de terminaison

Créer une salle

Créer une nouvelle salle de réunion. L’utilisateur authentifié devient l’administrateur de la salle.

POST /api/room/create

En-têtes : Authorization: Bearer <accessToken>

Corps de la requête :

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

Note : Le champ name est optionnel. S’il est omis ou vide, le serveur générera automatiquement un nom aléatoire compatible URL au format xxx-xxxx-xxx (ex. bkf-qmzl-rja).

Règles de nom des salles :

Les noms de salles apparaissent dans l’URL sous la forme https://bedrud.xyz/m/NAME, ils doivent donc être compatibles URL :

Réponse (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"
}

Champs

Rejoindre une salle

Rejoindre une salle existante et recevoir un token LiveKit pour la connexion média.

POST /api/room/join

En-têtes : Authorization: Bearer <accessToken>

Corps de la requête :

{
  "roomName": "team-standup"
}

Réponse (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"
}

Le token est un token d’accès LiveKit signé. Utilisez-le pour vous connecter au serveur LiveKit via WebSocket :

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

Lister les salles

Obtenir une liste des salles créées par l’utilisateur.

GET /api/room/list

En-têtes : Authorization: Bearer <accessToken>

Réponse (200) :

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

Expulser un participant

Retirer un participant de la salle. Seul l’administrateur de la salle peut le faire.

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

En-têtes : Authorization: Bearer <accessToken>

Réponse (200) :

{
  "status": "success"
}

Couper le micro d’un participant

Couper le micro d’un participant. Seul l’administrateur de la salle peut le faire.

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

En-têtes : Authorization: Bearer <accessToken>

Réponse (200) :

{
  "status": "success"
}

Désactiver la vidéo d’un participant

Éteindre la caméra d’un participant. Seul l’administrateur de la salle peut le faire.

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

En-têtes : Authorization: Bearer <accessToken>

Réponse (200) :

{
  "status": "success"
}

Contrôles d’administrateur

Les actions d’administrateur de salle (expulsion, coupure micro, coupure vidéo) ne sont disponibles que pour l’utilisateur qui a créé la salle (adminId). Tenter ces actions en tant que non-admin renvoie une erreur 403.

Matrice des autorisations

Réponses d’erreur

Toutes les erreurs suivent un format cohérent :

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

Erreurs de création de salle

Erreurs générales

Voir aussi

• Vue d’ensemble de l’architecture - modèle de données et flux de connexion aux réunions
• Gestionnaires d’API - comment les points de terminaison de salle sont implémentés