Sesiones de grabación

Una sesión de grabación observa una página web mientras usted la utiliza y anota cada llamada API que realiza: REST, GraphQL, gRPC-web y WebSocket. Las llamadas capturadas se consultan como respuestas normales y, en los planes Pro y Enterprise, se convierten en una carpeta de solicitudes reales y reproducibles, rellenadas de antemano con lo que la página envió realmente.

Es el camino más corto para documentar una API de la que solo dispone del front-end: sin proxy que configurar, sin certificado que instalar, sin extensión de navegador.

Crear una sesión

Una sesión se crea en cualquier lugar del árbol — en la raíz, en una carpeta o en una carpeta de entorno — desde el menú contextual («Añadir» → «Sesión de grabación») o desde el menú «Crear»; solo un escenario no puede contener una. Aparece en la barra lateral como un nodo padre: al hacer clic en la propia sesión se abre su página de configuración, y cada una de sus filas hijas abre su propia pestaña.

La configuración se reduce a cuatro elementos:

• La url de la página que se abrirá en el mininavegador (http://, https:// o file://). El botón Iniciar la grabación permanece desactivado mientras no sea válida.
• Los protocolos que capturar: HTTP, WebSocket, GraphQL, gRPC-web — todos marcados por defecto.
• La lista blanca: expresiones regulares; una llamada se conserva si coincide con al menos una de ellas. Vacía, deja pasar todo.
• La lista negra: expresiones regulares; una llamada que coincide con alguna de ellas se descarta. La lista negra siempre tiene la última palabra.

Solo estos ajustes y las rutas deducidas se guardan en el archivo del proyecto. Las llamadas capturadas, en cambio, permanecen en memoria: desaparecen al cerrar el proyecto y nunca se escriben en el disco.

Grabar

El botón Iniciar la grabación abre la página en una pestaña del mininavegador y conecta el grabador antes de la primera carga, de modo que las llamadas que la página realiza al arrancar — incluida una conexión WebSocket abierta de inmediato — quedan capturadas. Un halo pulsante alrededor de la insignia de la sesión en la barra lateral, y alrededor de su pestaña, indica que la grabación está en curso.

Navegue y utilice la página con normalidad. Dos botones en la línea de dirección controlan la sesión:

• Pausar la grabación mantiene la página abierta pero deja de almacenar las llamadas — práctico para saltarse una pantalla sin interés.
• Detener la grabación desconecta el grabador y cierra la pestaña del navegador. Las capturas siguen disponibles.

Una grabación es siempre un gesto explícito: una pestaña del navegador restaurada al reabrir la aplicación no graba nada.

Los sitios que necesitan su ubicación se la piden al navegador, y por defecto el mininavegador no revela nada. El ajuste Compartir su ubicación con el navegador integrado, en la sección Privacidad de los ajustes de la aplicación y desactivado por defecto, proporciona su ubicación aproximada tras pedirle su consentimiento — desde el servicio de localización del sistema y, en su defecto, a partir de una estimación a nivel de ciudad basada en su dirección IP. Desactivarlo olvida la ubicación de inmediato.

Las capturas

La fila «Capturas» de la sesión abre la vista de las llamadas, agrupadas por ejecución de la más antigua a la más reciente y actualizadas en directo durante la grabación. Mientras la lista está desplazada hasta el final, sigue las últimas llamadas; suba para leer una y se queda quieta. Un campo de filtro acota la lista; el detalle de una llamada reutiliza exactamente las pestañas de respuesta de las solicitudes (cuerpo, información, cookies, grafo), protocolo por protocolo.

El menú contextual de una llamada propone añadirla a la lista blanca o a la lista negra, con su url rellenada de antemano como patrón. Puede aplicar el nuevo patrón a las llamadas ya capturadas: las que ya no pasan se eliminan, de forma definitiva — la aplicación pide confirmación.

El número de llamadas conservadas por sesión tiene un límite (1.000 por defecto, ajustable en los ajustes de la aplicación); más allá, las más antiguas se borran.

Deducir las rutas

En los planes Pro y Enterprise, el botón Deducir las rutas de la vista de capturas transforma las llamadas en un árbol bajo la fila «Rutas» de la sesión:

• las llamadas se agrupan por ruta: un segmento de ruta que varía de una llamada a otra (/pets/1, /pets/2) se convierte en un parámetro de ruta {{petId}};
• las carpetas siguen los prefijos estáticos de las rutas (api › pets); las llamadas gRPC-web se ordenan por servicio;
• cada ruta se convierte en una solicitud normal — HTTP, GraphQL, gRPC-web o WebSocket — rellenada de antemano a partir de la última llamada correcta (cabeceras, parámetros, cuerpo) y reproducible de inmediato;
• las llamadas capturadas se vierten en el historial de respuestas de cada solicitud, en el formato habitual y dentro del límite de retención configurado; la respuesta mostrada por defecto es la de la última llamada correcta.

Volver a lanzar la deducción tras nuevas grabaciones fusiona: solo se añaden las rutas nuevas, y las solicitudes existentes — incluidas las que usted haya modificado — permanecen intactas.

En el plan Community, la grabación y la consulta de las capturas están totalmente disponibles; la pestaña Rutas muestra un recordatorio de la funcionalidad Pro.

Desde un asistente de IA

Toda la funcionalidad está expuesta por el servidor MCP de Restorm: creación y configuración de una sesión, inicio y detención de la grabación, lectura de las capturas y deducción de las rutas. Un agente puede así abrir una página, dejarla funcionar y luego entregar una carpeta de solicitudes listas para usar.