Opptakssesjoner

En opptakssesjon observerer en nettside mens du bruker den og noterer hvert API-kall den gjør: REST, GraphQL, gRPC-web og WebSocket. De fangede kallene kan leses som vanlige svar, og på Pro- og Enterprise-planene blir de til en mappe med ekte forespørsler som kan kjøres om igjen, forhåndsutfylt med det siden faktisk sendte.

Det er den korteste veien til å dokumentere et API der du bare har front-enden: ingen proxy å sette opp, ingen sertifikater å installere, ingen nettleserutvidelse.

Opprette en sesjon

En sesjon opprettes hvor som helst i treet — i roten, i en mappe eller i en miljømappe — fra kontekstmenyen («Legg til» → «Opptakssesjon») eller fra menyen «Opprett»; bare et scenario kan ikke inneholde en. Den vises i sidefeltet som en foreldrenode: et klikk på selve sesjonen åpner konfigurasjonssiden, og hver av barneradene åpner sin egen fane.

Konfigurasjonen består av fire ting:

• Sidens url som skal åpnes i mini-nettleseren (http://, https:// eller file://). Knappen «Start opptak» forblir deaktivert til url-en er gyldig.
• Protokollene som skal fanges: HTTP, WebSocket, GraphQL, gRPC-web — alle avkrysset som standard.
• Hvitelisten: regulære uttrykk; et kall beholdes hvis det matcher minst ett av dem. Er den tom, slipper alt gjennom.
• Svartelisten: regulære uttrykk; et kall som matcher ett av dem, forkastes. Svartelisten har alltid siste ord.

Bare disse innstillingene og de utledede rutene lagres i prosjektfilen. De fangede kallene blir i minnet: de forsvinner når prosjektet lukkes, og skrives aldri til disk.

Ta opp

Knappen «Start opptak» åpner siden i en mini-nettleser-fane og kobler på opptakeren før første innlasting, slik at kallene siden gjør ved oppstart — inkludert en WebSocket-tilkobling som åpnes umiddelbart — blir fanget. En pulserende glød rundt sesjonens merke i sidefeltet og rundt fanen dens viser at opptaket pågår.

Naviger og bruk siden som vanlig. To knapper på adresselinjen styrer sesjonen:

• Sett opptaket på pause holder siden åpen, men lagrer ikke lenger kall — praktisk for å komme seg forbi et skjermbilde uten interesse.
• Stopp opptaket kobler fra opptakeren og lukker nettleserfanen. Opptakene forblir tilgjengelige.

Et opptak er alltid en eksplisitt handling: en nettleserfane som gjenopprettes når programmet åpnes igjen, tar ikke opp noe.

Nettsteder som trenger posisjonen din, ber nettleseren om den, og som standard gir mini-nettleseren ingenting fra seg. Innstillingen Del posisjonen din med den innebygde nettleseren, under Personvern i programinnstillingene og avslått som standard, gir den omtrentlige posisjonen din etter å ha bedt om samtykket ditt — fra systemets posisjonstjeneste, og ellers fra et anslag på bynivå basert på IP-adressen din. Slår du den av, glemmes posisjonen straks.

Opptakene

Raden «Opptak» under sesjonen åpner visningen av kallene, gruppert etter kjøring fra den eldste til den nyeste og oppdatert direkte mens opptaket pågår. Så lenge listen er rullet helt til bunnen, følger den de nyeste kallene; rull opp for å lese et av dem, og den blir stående. Et filterfelt begrenser listen; detaljene for et kall gjenbruker nøyaktig svarfanene til forespørslene (innhold, informasjon, cookies, graf), protokoll for protokoll.

Kontekstmenyen til et kall tilbyr «Legg til i hvitelisten…» eller «Legg til i svartelisten…», med url-en forhåndsutfylt som mønster. Du kan anvende det nye mønsteret på kallene som allerede er fanget: de som ikke lenger slipper gjennom, slettes — for godt, så programmet ber om bekreftelse.

Antall kall som beholdes per sesjon, er begrenset (1 000 som standard, justerbart i programinnstillingene); over grensen slettes de eldste.

Utlede rutene

På Pro- og Enterprise-planene gjør knappen Utled rutene i opptaksvisningen kallene om til et tre under raden «Ruter» i sesjonen:

• kallene grupperes etter rute: et stisegment som varierer fra kall til kall (/pets/1, /pets/2) blir en stiparameter {{petId}};
• mappene følger de statiske prefiksene i stiene (api › pets); gRPC-web-kall sorteres etter tjeneste;
• hver rute blir en vanlig forespørsel — HTTP, GraphQL, gRPC-web eller WebSocket — forhåndsutfylt fra det siste vellykkede kallet (headere, parametere, innhold) og klar til å kjøres om igjen umiddelbart;
• de fangede kallene skrives inn i svarhistorikken til hver forespørsel, i det vanlige formatet og innenfor den konfigurerte oppbevaringsgrensen; svaret som vises som standard, er det fra det siste vellykkede kallet.

Å kjøre utledningen igjen etter nye opptak fletter resultatet: bare nye ruter legges til, og eksisterende forespørsler — også de du har endret — forblir urørt.

På Community-planen er opptak og gjennomgang av opptakene fullt tilgjengelig; fanen Ruter viser en påminnelse om Pro-funksjonen.

Fra en AI-assistent

Hele funksjonen er tilgjengelig via Restorms MCP-server: opprette og konfigurere en sesjon, starte og stoppe opptaket, lese opptakene og utlede rutene. En agent kan dermed åpne en side, la den kjøre, og så levere en mappe med forespørsler som er klare til bruk.