Référence API

Tous les points d'entrée de la Room API (machine-à-machine), authentifiés par clé d'API.

URL de base

base
https://meet.lunion-lab.com/api/v1

Authentifiez chaque requête avec votre clé d'API dans l'en-tête Authorization: Bearer lk_xxxxx.secret.

Salles

POST/sdk/rooms
Créer une salle. Corps : { name, scheduledAt?, description? }.
GET/sdk/rooms
Lister les salles de l'application.
DELETE/sdk/rooms/:slug
Supprimer une salle.

Jetons

POST/sdk/rooms/:slug/token
Émettre un jeton de connexion pour la salle.

Corps de la requête :

POST /sdk/rooms/:slug/token
{  "identity": "user-42",       // requis : votre identifiant utilisateur  "name": "Awa Diop",          // facultatif : nom affiché  "metadata": "role=client",   // facultatif : métadonnées libres  "ttlSeconds": 3600,          // facultatif : 60–86400, défaut 21600 (6 h)  "grants": {                  // facultatif : droits restreints    "canPublish": true,    "canSubscribe": true,    "canPublishData": true,    "hidden": false,    "roomAdmin": false,    "roomRecord": false  }}

Réponse :

200 OK
{  "token": "eyJhbGciOi...",  "url": "wss://meet.lunion-lab.com/sfu",  "room": "calm-otter-1289",  "identity": "user-42",  "expiresAt": 1782900000}

Erreurs

L'API renvoie des codes HTTP standards et un corps JSON décrivant l'erreur.

  • 401, clé d'API absente ou invalide.
  • 404, ressource introuvable (ou hors de votre application).
  • 400, requête invalide (paramètre manquant ou mal typé).
  • 429, trop de requêtes (limitation de débit).

SDK

  • @lunionlab/meet-server-sdk, côté serveur : RoomServiceClient (salles + jetons), WebhookReceiver (vérification de signature).
  • @lunionlab/meet-react, côté client React : useLunionRoom, VideoTrack.
  • @lunionlab/meet-client-js, côté client bas niveau : SfuClient.

Référence OpenAPI

Une spécification OpenAPI interactive complète est disponible sur /docs de votre instance API (Swagger).