Capítulo 8 GET POST

isMeetingRunning – Comprobar estado de la reunión

El endpoint isMeetingRunning comprueba si una reunión específica está activa actualmente en el servidor BigBlueButton. Devuelve un valor booleano simple, lo que la convierte en la llamada de supervisión más ligera disponible en la API.

Endpoint

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

Este endpoint siempre devuelve un código de retorno SUCCESS, incluso si el ID de reunión proporcionado no existe. En ese caso, el valor running simplemente es false.

Parámetros obligatorios

Parámetro Tipo Obligatorio Descripción
meetingID String Sí El ID de la reunión que desea comprobar.

Ejemplo de solicitud

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

Respuesta de ejemplo

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

Campos de respuesta

Campo Tipo Descripción
returncode String Siempre SUCCESS para este endpoint, independientemente de si la reunión existe.
running Boolean true si la reunión está actualmente en ejecución, false si no está en ejecución o si el ID de la reunión es desconocido.

¿Cuándo se considera que una reunión está en ejecución?

Una reunión se considera en ejecución una vez que al menos un participante se ha unido. Una reunión recién creada sin asistentes devolverá running como false, aunque exista en el servidor.

Llame a create para configurar una nueva reunión en el servidor.

En este punto, isMeetingRunning devuelve false — todavía no se ha unido nadie.

Un participante se une mediante join. La reunión ahora está en ejecución.

isMeetingRunning ahora devuelve true.

Notas para usuarios de bbbserver.de

En las instancias administradas de bbbserver.de, la suma de verificación de la API se calcula automáticamente cuando usas las herramientas de API integradas. No necesitas calcularla manualmente.

Consejos y mejores prácticas

Aunque isMeetingRunning es adecuado para una simple consulta periódica de estado, considera usar webhooks para una supervisión en tiempo real más eficiente. Consultar este endpoint con alta frecuencia añade una carga innecesaria al servidor.

No te bases solo en isMeetingRunning para obtener un estado detallado de la reunión. Usa getMeetingInfo en su lugar si necesitas recuentos de participantes, estado de grabación u otros metadatos.

  • Use este endpoint para comprobaciones ligeras de estado o paneles simples que solo necesiten saber si una reunión está activa.
  • Combínalo con getMeetings si necesitas supervisar varias reuniones a la vez: una sola llamada a getMeetings es más eficiente que muchas llamadas individuales a isMeetingRunning.
  • Mantenga su intervalo de consulta en un rango razonable (por ejemplo, cada 30 a 60 segundos) para evitar imponer una carga innecesaria al servidor.

Preguntas frecuentes

El endpoint sigue devolviendo SUCCESS con running establecido en false. No produce un error para ID de reunión desconocidos.

No. Una reunión solo se considera en ejecución una vez que al menos un participante se ha unido. Una reunión que fue creada pero no tiene asistentes devuelve running como false.

Para comprobaciones simples de estado, sí. Sin embargo, para una monitorización en tiempo real basada en eventos, los webhooks son una alternativa más eficiente, ya que envían las actualizaciones a su aplicación en lugar de requerir consultas repetidas.

isMeetingRunning devuelve solo un valor booleano que indica si la reunión está activa. getMeetingInfo devuelve detalles completos, incluidas listas de participantes, estado de grabación, metadatos y más. Usa isMeetingRunning cuando solo necesites una respuesta rápida de sí o no.

Sí. La API de BigBlueButton acepta solicitudes tanto GET como POST para isMeetingRunning. Los parámetros y la respuesta son idénticos independientemente del método HTTP utilizado.