Hoofdstuk 8 GET POST

isMeetingRunning – Vergaderstatus controleren

Het endpoint isMeetingRunning controleert of een specifieke vergadering momenteel actief is op de BigBlueButton-server. Het retourneert een eenvoudige booleaanse waarde, waardoor het de lichtste monitoringaanroep in de API is.

Endpoint

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

Dit endpoint retourneert altijd een returncode SUCCESS, zelfs als de opgegeven meeting-ID niet bestaat. In dat geval is de waarde van running simpelweg false.

Vereiste parameters

Parameter Type Vereist Beschrijving
meetingID String Ja De meeting-ID van de vergadering die je wilt controleren.

Voorbeeldverzoek

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

Voorbeeldrespons

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

Responsvelden

Veld Type Beschrijving
returncode String Altijd SUCCESS voor dit endpoint, ongeacht of de vergadering bestaat.
running Boolean true als de vergadering momenteel actief is, false als deze niet actief is of als de meeting-ID onbekend is.

Wanneer wordt een vergadering als actief beschouwd?

Een vergadering wordt als actief beschouwd zodra ten minste één deelnemer heeft deelgenomen. Een net aangemaakte vergadering zonder deelnemers retourneert running als false, ook al bestaat deze op de server.

Roep create aan om een nieuwe vergadering op de server aan te maken.

Op dit moment retourneert isMeetingRunning false — er is nog niemand toegetreden.

Een deelnemer treedt toe via join. De vergadering is nu actief.

isMeetingRunning retourneert nu true.

Opmerkingen voor gebruikers van bbbserver.de

Op beheerde instances van bbbserver.de wordt de API-checksum automatisch berekend wanneer je de ingebouwde API-tools gebruikt. Je hoeft deze niet handmatig te berekenen.

Tips en best practices

Hoewel isMeetingRunning geschikt is voor eenvoudige statuspolling, kun je voor efficiëntere realtime monitoring beter webhooks gebruiken. Dit endpoint met hoge frequentie pollen veroorzaakt onnodige belasting van de server.

Vertrouw niet alleen op isMeetingRunning voor gedetailleerde vergaderstatus. Gebruik in plaats daarvan getMeetingInfo als je deelnemersaantallen, opnamestatus of andere metadata nodig hebt.

  • Gebruik dit endpoint voor lichte health checks of eenvoudige dashboards die alleen hoeven te weten of een vergadering actief is.
  • Combineer het met getMeetings als je meerdere vergaderingen tegelijk wilt monitoren — één aanroep van getMeetings is efficiënter dan veel afzonderlijke aanroepen van isMeetingRunning.
  • Houd je pollinginterval redelijk (bijvoorbeeld elke 30 tot 60 seconden) om onnodige belasting van de server te voorkomen.

Veelgestelde vragen

Het endpoint retourneert nog steeds SUCCESS met running ingesteld op false. Het geeft geen fout voor onbekende meeting-ID's.

Nee. Een vergadering wordt pas als actief beschouwd zodra ten minste één deelnemer heeft deelgenomen. Een vergadering die is aangemaakt maar geen deelnemers heeft, retourneert running als false.

Voor eenvoudige statuscontroles wel. Voor realtime, gebeurtenisgestuurde monitoring zijn webhooks echter een efficiënter alternatief, omdat zij updates naar je applicatie pushen in plaats van herhaald pollen te vereisen.

isMeetingRunning retourneert alleen een booleaanse waarde die aangeeft of de vergadering actief is. getMeetingInfo retourneert uitgebreide details, waaronder deelnemerslijsten, opnamestatus, metadata en meer. Gebruik isMeetingRunning wanneer je alleen een snel ja-of-nee-antwoord nodig hebt.

Ja. De BigBlueButton-API accepteert zowel GET- als POST-verzoeken voor isMeetingRunning. De parameters en het antwoord zijn identiek, ongeacht de gebruikte HTTP-methode.