Obtener Información de Salas Anteriores

Punto final: /room/fetchPastRooms

Este punto final le permite recuperar información histórica sobre las sesiones de sala que ya han concluido. Después de que finaliza una sesión, ya sea cuando el último participante se va o cuando se termina a través de la API end, sus metadatos se almacenan y se pueden acceder mediante esta API.

Esto es particularmente útil para crear funciones que requieren un historial de reuniones pasadas, como mostrar una lista de sesiones anteriores en la interfaz de usuario de su aplicación. Puede consultar uno o más room_id para obtener detalles como cuándo se creó la sesión, cuándo terminó y cuántos participantes se unieron.

Parámetros de la Solicitud

Campo	Tipo	Requerido	Descripción
room_ids	array	Sí	Un array de IDs de sala para consultar.
from	number	No	Índice inicial para los registros. El valor predeterminado es 0.
limit	number	No	Número máximo de registros a devolver. El valor predeterminado es 20.
order_by	string	No	Orden de clasificación: DESC o ASC. El valor predeterminado es DESC.

Ejemplo de Solicitud:

{
  "room_ids": ["sala01"],
  "from": 0,
  "limit": 20,
  "order_by": "DESC"
}

Respuesta

Campo	Tipo	Posición	Descripción
status	boolean	raíz	Indica si la solicitud fue exitosa.
msg	string	raíz	Mensaje de respuesta.
status_code	string	raíz	Código de estado de la respuesta.
result	object	raíz	Contiene los datos de los resultados.

Resultado

Campo	Tipo	Descripción
total_rooms	number	Número total de salas encontradas para la consulta.
from	number	Índice inicial de los registros devueltos.
limit	number	Número de registros devueltos.
order_by	string	Orden de clasificación utilizado para los registros.
rooms_list	Array<Información de Sala Anterior>	Lista de registros de salas anteriores.

Información de Sala Anterior

Campo	Tipo	Descripción
room_title	string	Título de la sala.
room_id	string	Identificador único de la sala.
room_sid	string	SID (Identificador de Sesión) de la sala.
joined_participants	number	Número de participantes que se unieron (puede no ser exacto; utilice los análisis para obtener información detallada).
webhook_url	string	URL del webhook asociada a la sala.
created	string	Fecha y hora de creación de la sala.
ended	string	Fecha y hora de finalización de la sala.
analytics_file_id	string	Identificador del archivo de análisis, si está disponible.