Sesiuni de înregistrare

O sesiune de înregistrare observă o pagină web în timp ce o folosiți și notează fiecare apel de API pe care aceasta îl efectuează: REST, GraphQL, gRPC-web și WebSocket. Apelurile capturate se consultă ca niște răspunsuri obișnuite și, pe planurile Pro și Enterprise, se transformă într-un folder de cereri reale, rejucabile, precompletate cu ceea ce pagina a trimis cu adevărat.

Este cea mai scurtă cale pentru a documenta o API din care nu aveți decât front-end-ul: niciun proxy de configurat, niciun certificat de instalat, nicio extensie de browser.

Crearea unei sesiuni

O sesiune se creează oriunde în arbore — la rădăcină, într-un folder sau într-un folder de mediu — din meniul contextual („Adaugă” → „Sesiune de înregistrare”) sau din meniul „Creare”; doar un scenariu nu poate conține una. Ea apare în bara laterală ca un nod părinte: pagina de configurare se deschide printr-un clic pe sesiunea însăși, iar fiecare dintre liniile sale copil își deschide propria filă.

Pagina de configurare a unei sesiuni de înregistrare: url-ul paginii, protocoalele capturate, lista albă și lista neagră, și butonul Pornește înregistrarea

Configurarea se rezumă la patru elemente:

Url-ul paginii de deschis în mini-browser (http://, https:// sau file://). Butonul „Pornește înregistrarea” rămâne dezactivat câtă vreme url-ul nu este valid.
Protocoalele de capturat: HTTP, WebSocket, GraphQL, gRPC-web — toate bifate în mod implicit.
Lista albă: expresii regulate; un apel este păstrat dacă se potrivește cu cel puțin una dintre ele. Goală, lasă totul să treacă.
Lista neagră: expresii regulate; un apel care se potrivește cu una dintre ele este eliminat. Lista neagră are întotdeauna ultimul cuvânt.

Doar aceste setări și rutele deduse sunt salvate în fișierul proiectului. Apelurile capturate, în schimb, rămân în memorie: dispar la închiderea proiectului și nu sunt scrise niciodată pe disc.

Înregistrarea

Butonul „Pornește înregistrarea” deschide pagina într-o filă de mini-browser și atașează înregistratorul înainte de prima încărcare, astfel încât apelurile efectuate la pornirea paginii — inclusiv o conexiune WebSocket deschisă imediat — sunt capturate. Un halou pulsant în jurul insignei sesiunii din bara laterală, și în jurul filei sale, semnalează că înregistrarea este în curs.

Mini-browserul în timpul unei înregistrări: pagina site-ului, butoanele Pune înregistrarea pe pauză și Oprește înregistrarea pe linia de adresă, insigna roșie pe sesiune

Navigați și folosiți pagina în mod normal. Două butoane de pe linia de adresă controlează sesiunea:

Pune înregistrarea pe pauză păstrează pagina deschisă, dar nu mai stochează apelurile — practic pentru a trece peste un ecran fără interes.
Oprește înregistrarea detașează înregistratorul și închide fila browserului. Capturile rămân disponibile.

O înregistrare este întotdeauna un gest explicit: o filă de browser restaurată la redeschiderea aplicației nu înregistrează nimic.

Site-urile care au nevoie de locația dumneavoastră o cer browserului, iar în mod implicit mini-browserul nu dezvăluie nimic. Setarea Partajarea locației dumneavoastră cu browserul integrat, din secțiunea Confidențialitate a setărilor aplicației și dezactivată în mod implicit, furnizează locația dumneavoastră aproximativă după ce vă cere consimțământul — de la serviciul de localizare al sistemului, iar în lipsa acestuia dintr-o estimare la nivel de oraș bazată pe adresa dumneavoastră IP. Dezactivarea ei uită locația imediat.

Capturile

Linia „Capturi” a sesiunii deschide vizualizarea apelurilor, grupate pe execuții de la cea mai veche la cea mai recentă și actualizate în direct în timpul înregistrării. Cât timp lista este derulată până jos, urmărește cele mai noi apeluri; derulați în sus pentru a citi unul și lista rămâne pe loc. Un câmp de filtrare restrânge lista; detaliul unui apel refolosește exact filele de răspuns ale cererilor (corp, informații, cookie-uri, grafic), protocol cu protocol.

Vizualizarea capturilor: lista apelurilor grupate pe execuții în stânga, detaliul apelului selectat în dreapta cu filele sale de răspuns

Meniul contextual al unui apel propune adăugarea lui la lista albă sau la lista neagră, cu url-ul său precompletat ca model. Puteți aplica noul model apelurilor deja capturate: cele care nu mai trec sunt șterse, definitiv — aplicația cere confirmare.

Numărul de apeluri păstrate per sesiune este plafonat (1.000 în mod implicit, reglabil din setările aplicației); peste această limită, cele mai vechi se șterg.

Deducerea rutelor

Pe planurile Pro și Enterprise, butonul Deduceți rutele din vizualizarea capturilor transformă apelurile într-o arborescență sub linia „Rute” a sesiunii:

apelurile sunt grupate pe rute: un segment de cale care variază de la un apel la altul (/pets/1, /pets/2) devine un parametru de cale {{petId}};
folderele urmează prefixele statice ale căilor (api › pets); apelurile gRPC-web sunt aranjate pe servicii;
fiecare rută devine o cerere obișnuită — HTTP, GraphQL, gRPC-web sau WebSocket — precompletată pornind de la ultimul apel reușit (antete, parametri, corp) și rejucabilă imediat;
apelurile capturate sunt vărsate în istoricul de răspunsuri al fiecărei cereri, în formatul obișnuit și în limita de retenție configurată; răspunsul afișat în mod implicit este cel al ultimului apel reușit.

Linia Rute a sesiunii desfășurată: folderele deduse și cererile lor, gata de a fi rejucate

Relansarea deducerii după noi înregistrări fuzionează: doar rutele noi sunt adăugate, iar cererile existente — inclusiv cele pe care le-ați modificat — rămân neatinse.

Pe planul Community, înregistrarea și consultarea capturilor sunt disponibile în întregime; fila Rute afișează o notă despre funcționalitatea Pro.

Dintr-un asistent IA

Întreaga funcționalitate este expusă de serverul MCP al Restorm: crearea și configurarea unei sesiuni, pornirea și oprirea înregistrării, citirea capturilor și deducerea rutelor. Un agent poate astfel deschide o pagină, o poate lăsa să ruleze, apoi vă poate preda un folder de cereri gata de utilizare.