Capitolo 8 GET POST

isMeetingRunning – Controlla stato della riunione

L'endpoint isMeetingRunning verifica se una specifica riunione è attualmente attiva sul server BigBlueButton. Restituisce un semplice valore booleano, rendendolo la chiamata di monitoraggio più leggera disponibile nell'API.

Endpoint

GET/POST https://api-guide.bbbserver.com/bigbluebutton/api/isMeetingRunning?meetingID=replace-with-meeting-id&checksum=replace-with-checksum

Questo endpoint restituisce sempre un codice di ritorno SUCCESS, anche se l'ID riunione fornito non esiste. In tal caso il valore running è semplicemente false.

Parametri obbligatori

Parametro Tipo Obbligatorio Descrizione
meetingID String Sì L'ID della riunione che vuoi verificare.

Esempio di richiesta

https://api-guide.bbbserver.com/bigbluebutton/api/isMeetingRunning?meetingID=replace-with-meeting-id&checksum=replace-with-checksum

Risposta di esempio

<response>
  <returncode>SUCCESS</returncode>
  <running>true</running>
</response>

Campi della risposta

Campo Tipo Descrizione
returncode String Sempre SUCCESS per questo endpoint, indipendentemente dal fatto che la riunione esista.
running Boolean true se la riunione è attualmente in esecuzione, false se non è in esecuzione o se l'ID riunione è sconosciuto.

Quando una riunione è considerata in esecuzione?

Una riunione è considerata in esecuzione una volta che almeno un partecipante si è collegato. Una riunione appena creata senza partecipanti restituirà running come false, anche se esiste sul server.

Chiama create per impostare una nuova riunione sul server.

A questo punto, isMeetingRunning restituisce false — non si è ancora unito nessuno.

Un partecipante si unisce tramite join. La riunione è ora in esecuzione.

isMeetingRunning ora restituisce true.

Note per gli utenti di bbbserver.de

Sulle istanze gestite bbbserver.de, il checksum API viene calcolato automaticamente quando usi gli strumenti API integrati. Non è necessario calcolarlo manualmente.

Suggerimenti e buone pratiche

Sebbene isMeetingRunning sia adatto per un semplice polling dello stato, valuta l'uso dei webhook per un monitoraggio in tempo reale più efficiente. Interrogare questo endpoint ad alta frequenza aggiunge carico inutile al server.

Non fare affidamento solo su isMeetingRunning per uno stato dettagliato della riunione. Usa invece getMeetingInfo se hai bisogno del numero di partecipanti, dello stato della registrazione o di altri metadati.

  • Usa questo endpoint per controlli leggeri dello stato di salute o semplici dashboard che devono solo sapere se una riunione è attiva.
  • Combinalo con getMeetings se devi monitorare più riunioni contemporaneamente — una singola chiamata getMeetings è più efficiente di molte chiamate individuali isMeetingRunning.
  • Mantieni ragionevole il tuo intervallo di polling (ad esempio ogni 30-60 secondi) per evitare di imporre un carico inutile al server.

Domande frequenti

L'endpoint restituisce comunque SUCCESS con running impostato su false. Non produce un errore per ID riunione sconosciuti.

No. Una riunione è considerata in esecuzione solo quando almeno un partecipante si è collegato. Una riunione che è stata creata ma non ha partecipanti restituisce running come false.

Per semplici controlli di stato, sì. Tuttavia, per un monitoraggio in tempo reale basato su eventi, i webhook sono un'alternativa più efficiente poiché inviano gli aggiornamenti alla tua applicazione invece di richiedere polling ripetuti.

isMeetingRunning restituisce solo un booleano che indica se la riunione è attiva. getMeetingInfo restituisce dettagli completi, inclusi elenchi dei partecipanti, stato della registrazione, metadati e altro. Usa isMeetingRunning quando ti serve solo una risposta rapida sì o no.

Sì. L'API BigBlueButton accetta sia richieste GET sia POST per isMeetingRunning. I parametri e la risposta sono identici indipendentemente dal metodo HTTP usato.