Opnamesessies

Een opnamesessie observeert een webpagina terwijl u die gebruikt en noteert elke API-aanroep die ze doet: REST, GraphQL, gRPC-web en WebSocket. De vastgelegde aanroepen leest u als gewone antwoorden en op de Pro- en Enterprise-abonnementen worden ze een map met echte, opnieuw uitvoerbare verzoeken, vooraf ingevuld met wat de pagina werkelijk heeft verzonden.

Het is de kortste weg om een API te documenteren waarvan u alleen de front-end hebt: geen proxy om in te stellen, geen certificaat om te installeren, geen browserextensie.

Een sessie aanmaken

Een sessie maakt u overal in de boom aan — in de root, in een map of in een omgevingsmap — vanuit het contextmenu (“Toevoegen” → “Opnamesessie”) of vanuit het menu “Aanmaken”; alleen een scenario kan er geen bevatten. Ze verschijnt in de zijbalk als een bovenliggend knooppunt: een klik op de sessie zelf opent de configuratiepagina, en elk van haar onderliggende rijen opent een eigen tabblad.

Configuratiepagina van een opnamesessie: de url van de pagina, de vast te leggen protocollen, de witte lijst en de zwarte lijst, en de knop Opname starten

De configuratie komt neer op vier onderdelen:

De url van de pagina die in de minibrowser wordt geopend (http://, https:// of file://). De knop “Opname starten” blijft uitgeschakeld tot de url geldig is.
De protocollen die worden vastgelegd: HTTP, WebSocket, GraphQL, gRPC-web — standaard allemaal aangevinkt.
De witte lijst: reguliere expressies; een aanroep wordt bewaard als ze met minstens één ervan overeenkomt. Leeg laat ze alles door.
De zwarte lijst: reguliere expressies; een aanroep die met een ervan overeenkomt, wordt weggelaten. De zwarte lijst heeft altijd het laatste woord.

Alleen deze instellingen en de afgeleide routes worden in het projectbestand opgeslagen. De vastgelegde aanroepen blijven in het geheugen: ze verdwijnen wanneer het project wordt gesloten en worden nooit naar de schijf geschreven.

Opnemen

De knop “Opname starten” opent de pagina in een tabblad van de minibrowser en koppelt de recorder vóór de eerste keer laden, zodat de aanroepen die de pagina bij het opstarten doet — inclusief een WebSocket-verbinding die meteen wordt geopend — worden vastgelegd. Een pulserende gloed rond de badge van de sessie in de zijbalk, en rond haar tabblad, geeft aan dat de opname loopt.

De minibrowser tijdens een opname: de pagina van de site, de knoppen Opname pauzeren en Opname stoppen op de adresbalk, de rode badge op de sessie

Blader door de pagina en gebruik haar zoals gewoonlijk. Twee knoppen op de adresbalk besturen de sessie:

Opname pauzeren houdt de pagina open, maar slaat geen aanroepen meer op — handig om een oninteressant scherm over te slaan.
Opname stoppen koppelt de recorder los en sluit het browsertabblad. De opnamen blijven beschikbaar.

Opnemen is altijd een uitdrukkelijke handeling: een browsertabblad dat bij het heropenen van de toepassing wordt hersteld, neemt niets op.

Sites die uw locatie nodig hebben, vragen die aan de browser, en standaard geeft de minibrowser niets prijs. De instelling Uw locatie delen met de ingebouwde browser, in de sectie Privacy van de toepassingsinstellingen en standaard uitgeschakeld, levert uw geschatte locatie nadat om uw toestemming is gevraagd — van de locatieservice van het systeem, en anders van een schatting op stadsniveau op basis van uw IP-adres. Bij het uitschakelen wordt de locatie meteen vergeten.

De opnamen

De rij “Opnamen” van de sessie opent de weergave van de aanroepen, gegroepeerd per uitvoering van de oudste naar de nieuwste en live bijgewerkt tijdens het opnemen. Zolang de lijst helemaal naar beneden is gescrold, volgt ze de nieuwste aanroepen; scrol omhoog om er een te lezen en ze blijft staan. Een filterveld beperkt de lijst; het detail van een aanroep hergebruikt precies de antwoordtabbladen van de verzoeken (body, informatie, cookies, grafiek), protocol per protocol.

De opnamenweergave: links de lijst met aanroepen gegroepeerd per uitvoering, rechts het detail van de geselecteerde aanroep met zijn antwoordtabbladen

Het contextmenu van een aanroep biedt “Toevoegen aan de witte lijst…” of “Toevoegen aan de zwarte lijst…”, met de url vooraf ingevuld als patroon. U kunt het nieuwe patroon toepassen op de reeds vastgelegde aanroepen: de aanroepen die er niet meer doorheen komen, worden verwijderd — definitief, dus de toepassing vraagt om bevestiging.

Het aantal aanroepen dat per sessie wordt bewaard, is begrensd (standaard 1 000, instelbaar in de instellingen van de toepassing); daarboven verdwijnen de oudste.

De routes afleiden

Op de Pro- en Enterprise-abonnementen zet de knop Routes afleiden in de opnamenweergave de aanroepen om in een boom onder de rij “Routes” van de sessie:

de aanroepen worden per route gegroepeerd: een padsegment dat van aanroep tot aanroep verandert (/pets/1, /pets/2) wordt een padparameter {{petId}};
de mappen volgen de statische voorvoegsels van de paden (api › pets); gRPC-web-aanroepen worden per service ingedeeld;
elke route wordt een gewoon verzoek — HTTP, GraphQL, gRPC-web of WebSocket — vooraf ingevuld op basis van de laatste geslaagde aanroep (headers, parameters, body) en meteen opnieuw uitvoerbaar;
de vastgelegde aanroepen worden in de antwoordgeschiedenis van elk verzoek geschreven, in het gebruikelijke formaat en binnen de ingestelde bewaarlimiet; het antwoord dat standaard wordt getoond, is dat van de laatste geslaagde aanroep.

De rij Routes van de sessie uitgevouwen: de afgeleide mappen en hun verzoeken, klaar om opnieuw te worden uitgevoerd

De afleiding opnieuw uitvoeren na nieuwe opnamen voegt samen: alleen nieuwe routes worden toegevoegd en de bestaande verzoeken — ook die u hebt gewijzigd — blijven onaangeroerd.

Op het Community-abonnement zijn opnemen en het bekijken van de opnamen volledig beschikbaar; het tabblad Routes toont een herinnering aan de Pro-functie.

Vanuit een AI-assistent

De volledige functie wordt ontsloten door de MCP-server van Restorm: een sessie aanmaken en configureren, de opname starten en stoppen, de opnamen lezen en de routes afleiden. Een agent kan zo een pagina openen, haar laten draaien en vervolgens een map met gebruiksklare verzoeken afleveren.