Sessioni di registrazione

Una sessione di registrazione osserva una pagina web mentre Lei la usa e annota ogni chiamata API che effettua: REST, GraphQL, gRPC-web e WebSocket. Le chiamate acquisite si consultano come risposte ordinarie e, nei piani Pro ed Enterprise, si trasformano in una cartella di vere richieste rieseguibili, precompilate con ciò che la pagina ha realmente inviato.

È la via più breve per documentare un’API di cui possiede soltanto il front-end: nessun proxy da configurare, nessun certificato da installare, nessuna estensione del browser.

Creare una sessione

Una sessione si crea in qualsiasi punto dell’albero — alla radice, in una cartella o in una cartella di ambiente — dal menu contestuale («Aggiungi» → «Sessione di registrazione») oppure dal menu «Crea»; solo uno scenario non può contenerne una. Compare nell’albero laterale come nodo padre: un clic sulla sessione stessa apre la pagina di configurazione, mentre ciascuna delle sue righe figlie apre una scheda propria.

La configurazione si riduce a quattro elementi:

• L’url della pagina da aprire nel mini browser (http://, https:// o file://). Il pulsante «Avvia la registrazione» resta disattivato finché l’url non è valido.
• I protocolli da acquisire: HTTP, WebSocket, GraphQL, gRPC-web — tutti selezionati per impostazione predefinita.
• La lista bianca: espressioni regolari; una chiamata viene conservata se corrisponde ad almeno una di esse. Vuota, lascia passare tutto.
• La lista nera: espressioni regolari; una chiamata che corrisponde a una di esse viene scartata. La lista nera ha sempre l’ultima parola.

Nel file di progetto vengono salvate soltanto queste impostazioni e le route dedotte. Le chiamate acquisite, invece, restano in memoria: scompaiono alla chiusura del progetto e non vengono mai scritte su disco.

Registrare

Il pulsante «Avvia la registrazione» apre la pagina in una scheda del mini browser e collega il registratore prima del primo caricamento, così le chiamate effettuate dalla pagina all’avvio — compresa una connessione WebSocket aperta subito — vengono acquisite. Un alone pulsante attorno al badge della sessione nell’albero laterale, e attorno alla sua scheda, segnala che la registrazione è in corso.

Navighi e usi la pagina normalmente. Due pulsanti sulla barra dell’indirizzo controllano la sessione:

• Metti in pausa la registrazione mantiene la pagina aperta ma smette di memorizzare le chiamate — comodo per attraversare una schermata priva di interesse.
• Interrompi la registrazione scollega il registratore e chiude la scheda del browser. Le acquisizioni restano disponibili.

Registrare è sempre un gesto esplicito: una scheda del browser ripristinata alla riapertura dell’applicazione non registra nulla.

I siti che hanno bisogno della Sua posizione la chiedono al browser e, per impostazione predefinita, il mini browser non rivela nulla. L’impostazione Condividere la sua posizione con il browser integrato, nella sezione Privacy delle impostazioni dell’applicazione e disattivata per impostazione predefinita, fornisce la Sua posizione approssimativa dopo averLe chiesto il consenso — dal servizio di localizzazione del sistema, altrimenti da una stima a livello di città basata sul Suo indirizzo IP. Disattivarla dimentica subito la posizione.

Le acquisizioni

La riga «Acquisizioni» della sessione apre la vista delle chiamate, raggruppate per esecuzione dalla più vecchia alla più recente e aggiornate in tempo reale durante la registrazione. Finché l’elenco è scorso fino in fondo, segue le ultime chiamate; risalga per leggerne una e l’elenco non si muove più. Un campo di filtro restringe l’elenco; il dettaglio di una chiamata riutilizza esattamente le schede di risposta delle richieste (corpo, informazioni, cookie, grafico), protocollo per protocollo.

Il menu contestuale di una chiamata propone «Aggiungi alla lista bianca…» o «Aggiungi alla lista nera…», con il suo url precompilato come pattern. Può applicare il nuovo pattern alle chiamate già acquisite: quelle che non passano più vengono eliminate, definitivamente — l’applicazione chiede conferma.

Il numero di chiamate conservate per sessione è limitato (1.000 per impostazione predefinita, regolabile nelle impostazioni dell’applicazione); oltre quella soglia, le più vecchie vengono eliminate.

Dedurre le route

Nei piani Pro ed Enterprise, il pulsante Deduci le route della vista delle acquisizioni trasforma le chiamate in un albero sotto la riga «Route» della sessione:

• le chiamate vengono raggruppate per route: un segmento di percorso che varia da una chiamata all’altra (/pets/1, /pets/2) diventa un parametro di percorso {{petId}};
• le cartelle seguono i prefissi statici dei percorsi (api › pets); le chiamate gRPC-web vengono ordinate per servizio;
• ogni route diventa una richiesta ordinaria — HTTP, GraphQL, gRPC-web o WebSocket — precompilata a partire dall’ultima chiamata riuscita (header, parametri, corpo) e rieseguibile immediatamente;
• le chiamate acquisite vengono versate nella cronologia delle risposte di ciascuna richiesta, nel formato abituale e nel limite di conservazione configurato; la risposta mostrata per impostazione predefinita è quella dell’ultima chiamata riuscita.

Rilanciare la deduzione dopo nuove registrazioni fonde i risultati: vengono aggiunte soltanto le route nuove, mentre le richieste esistenti — comprese quelle che ha modificato — restano intatte.

Nel piano Community, la registrazione e la consultazione delle acquisizioni sono interamente disponibili; la scheda Route mostra un promemoria della funzionalità Pro.

Da un assistente IA

L’intera funzionalità è esposta dal server MCP di Restorm: creazione e configurazione di una sessione, avvio e interruzione della registrazione, lettura delle acquisizioni e deduzione delle route. Un agente può così aprire una pagina, lasciarla lavorare e poi consegnare una cartella di richieste pronte all’uso.