Optagelsessessioner

En optagelsessession holder øje med en webside, mens du bruger den, og noterer hvert API-kald, den foretager: REST, GraphQL, gRPC-web og WebSocket. De opsamlede kald læses som almindelige svar og bliver på Pro- og Enterprise-planerne til en mappe med rigtige anmodninger, der kan afspilles igen, udfyldt på forhånd med det, siden faktisk sendte.

Det er den korteste vej til at dokumentere et API, når du kun har dets frontend: ingen proxy at konfigurere, intet certifikat at installere, ingen browserudvidelse.

Opret en session

En session oprettes hvor som helst i træet — i roden, i en mappe eller i en miljømappe — fra kontekstmenuen („Tilføj“ → „Optagelsessession“) eller fra menuen „Opret“; kun et scenarie kan ikke indeholde en. Den vises i sidepanelet som en overordnet node: et klik på selve sessionen åbner dens konfigurationsside, og hver af dens underordnede rækker åbner sin egen fane.

Konfigurationen består af fire ting:

• Sidens url, som skal åbnes i minibrowseren (http://, https:// eller file://). Knappen Start optagelse er deaktiveret, indtil den er gyldig.
• Protokollerne, der skal opsamles: HTTP, WebSocket, GraphQL, gRPC-web — alle er afkrydset som standard.
• Hvidlisten: regulære udtryk; et kald beholdes, hvis det matcher mindst ét af dem. Er den tom, lader den alt passere.
• Sortlisten: regulære udtryk; et kald, der matcher et af dem, kasseres. Sortlisten har altid det sidste ord.

Kun disse indstillinger og de udledte ruter gemmes i projektfilen. De opsamlede kald bliver i hukommelsen: de forsvinder, når projektet lukkes, og skrives aldrig til disken.

Optag

Knappen Start optagelse åbner siden i en minibrowser-fane og kobler optageren til før den første indlæsning, så de kald, siden foretager under opstart — herunder en WebSocket, der åbnes med det samme — bliver opsamlet. En pulserende glød omkring sessionens mærke i sidepanelet og omkring dens fane viser, at optagelsen kører.

Naviger og brug siden som normalt. To knapper på adresselinjen styrer sessionen:

• Sæt optagelsen på pause holder siden åben, men gemmer ikke længere kaldene — praktisk til at springe en uinteressant skærm over.
• Stop optagelsen kobler optageren fra og lukker browserfanen. Optagelserne er stadig tilgængelige.

En optagelse er altid en bevidst handling: en browserfane, der gendannes, når appen åbnes igen, optager ingenting.

Sites, der har brug for din placering, beder browseren om den, og som standard afgiver minibrowseren intet. Indstillingen Del din placering med den indbyggede browser, under Privatliv i appens indstillinger og slået fra som standard, leverer din omtrentlige position efter at have bedt om dit samtykke — fra systemets placeringstjeneste, og ellers fra et skøn på byniveau baseret på din IP-adresse. Slår du den fra, glemmes positionen straks.

Optagelserne

Sessionens række „Optagelser“ åbner visningen af kaldene, grupperet pr. kørsel fra den ældste til den nyeste og opdateret live under optagelsen. Så længe listen er rullet helt til bunden, følger den de nyeste kald; rul op for at læse et af dem, og den bliver stående. Et filterfelt indsnævrer listen; detaljerne for et kald genbruger nøjagtigt anmodningernes svarfaner (krop, info, cookies, graf), protokol for protokol.

Et kalds kontekstmenu tilbyder at føje det til hvidlisten eller sortlisten med dets url udfyldt på forhånd som mønster. Du kan anvende det nye mønster på de kald, der allerede er opsamlet: dem, der ikke længere slipper igennem, fjernes — permanent — og appen beder om bekræftelse.

Antallet af kald, der beholdes pr. session, er begrænset (1.000 som standard, kan justeres i appens indstillinger); derudover slettes de ældste.

Udled ruterne

På Pro- og Enterprise-planerne omdanner knappen Udled ruterne i optagelsesvisningen kaldene til et træ under sessionens række „Ruter“:

• kaldene grupperes pr. rute: et stisegment, der varierer fra kald til kald (/pets/1, /pets/2), bliver til stiparameteren {{petId}};
• mapperne følger stiernes statiske præfikser (api › pets); gRPC-web-kald sorteres efter service;
• hver rute bliver til en almindelig anmodning — HTTP, GraphQL, gRPC-web eller WebSocket — udfyldt på forhånd ud fra det seneste vellykkede kald (headere, parametre, krop) og klar til at blive afspillet igen med det samme;
• de opsamlede kald lægges i hver anmodnings svarhistorik i det sædvanlige format og inden for den konfigurerede opbevaringsgrænse; svaret, der vises som standard, er det seneste vellykkede kalds.

Kører du udledningen igen efter nye optagelser, flettes resultatet: kun nye ruter tilføjes, og de eksisterende anmodninger — også dem, du har redigeret — forbliver uberørte.

På Community-planen er optagelse og gennemsyn af optagelserne fuldt tilgængelige; fanen Ruter viser en påmindelse om Pro-funktionen.

Fra en AI-assistent

Hele funktionen er tilgængelig via Restorms MCP-server: oprettelse og konfiguration af en session, start og stop af optagelsen, læsning af optagelserne og udledning af ruterne. En agent kan således åbne en side, lade den køre og derefter aflevere en mappe med anmodninger, der er klar til brug.