Aller au contenu
Restorm Restorm dokumentacija

Sesije snimanja

Sesija snimanja posmatra veb stranicu dok je koristite i beleži svaki API poziv koji ona upućuje: REST, GraphQL, gRPC-web i WebSocket. Zabeleženi pozivi pregledaju se kao obični odgovori i, na planovima Pro i Enterprise, pretvaraju se u fasciklu pravih zahteva koji se mogu ponovo izvršiti, unapred popunjenih onim što je stranica zaista poslala.

To je najkraći put da dokumentujete API od kojeg imate samo front-end: bez proxyja koji treba podesiti, bez sertifikata koji treba instalirati, bez proširenja za pregledač.

Kreiranje sesije

Section titled “Kreiranje sesije”

Sesija se kreira bilo gde u stablu — u korenu, u fascikli ili u fascikli okruženja — iz kontekstnog menija („Dodaj” → „Sesija snimanja”) ili iz menija „Kreiraj”; jedino je scenario ne može sadržati. U bočnoj traci se prikazuje kao roditeljski čvor: klik na samu sesiju otvara njenu stranicu za podešavanje, a svaki od njenih podređenih redova otvara sopstvenu karticu.

Stranica za podešavanje sesije snimanja: url stranice, protokoli koji se beleže, bela i crna lista i dugme Pokreni snimanje

Podešavanje se svodi na četiri stavke:

  • Url stranice koja se otvara u mini pregledaču (http://, https:// ili file://). Dugme „Pokreni snimanje” ostaje onemogućeno dok url nije važeći.
  • Protokoli koji se beleže: HTTP, WebSocket, GraphQL, gRPC-web — svi su podrazumevano označeni.
  • Bela lista: regularni izrazi; poziv se zadržava ako odgovara bar jednom od njih. Kada je prazna, propušta sve.
  • Crna lista: regularni izrazi; poziv koji odgovara nekom od njih se odbacuje. Crna lista uvek ima poslednju reč.

Samo ova podešavanja i izvedene rute čuvaju se u datoteci projekta. Zabeleženi pozivi ostaju u memoriji: nestaju pri zatvaranju projekta i nikada se ne upisuju na disk.

Snimanje

Section titled “Snimanje”

Dugme „Pokreni snimanje” otvara stranicu u kartici mini pregledača i priključuje snimač pre prvog učitavanja, tako da se beleže i pozivi koje stranica upućuje pri pokretanju — uključujući WebSocket vezu otvorenu odmah. Pulsirajući sjaj oko oznake sesije u bočnoj traci i oko njene kartice pokazuje da je snimanje u toku.

Mini pregledač tokom snimanja: stranica sajta, dugmad Pauziraj snimanje i Zaustavi snimanje u liniji adrese, crvena oznaka na sesiji

Krećite se po stranici i koristite je kao i inače. Dva dugmeta u liniji adrese upravljaju sesijom:

  • Pauziraj snimanje zadržava stranicu otvorenom, ali više ne beleži pozive — praktično kada želite da preskočite ekran koji vas ne zanima.
  • Zaustavi snimanje odvaja snimač i zatvara karticu pregledača. Snimci ostaju dostupni.

Snimanje je uvek izričita radnja: kartica pregledača vraćena pri ponovnom otvaranju aplikacije ne snima ništa.

Sajtovi kojima je potrebna vaša lokacija traže je od pregledača, a mini pregledač podrazumevano ne otkriva ništa. Postavka Deljenje vaše lokacije sa ugrađenim pregledačem, u odeljku Privatnost podešavanja aplikacije i podrazumevano isključena, daje vašu približnu lokaciju nakon što zatraži vašu saglasnost — iz sistemske usluge lociranja, a u suprotnom iz procene na nivou grada na osnovu vaše IP adrese. Njeno isključivanje odmah zaboravlja lokaciju.

Snimci

Section titled “Snimci”

Red „Snimci” sesije otvara prikaz poziva, grupisanih po izvršavanju od najstarijeg do najnovijeg i ažuriranih uživo tokom snimanja. Dok je lista pomerena do samog dna, prati najnovije pozive; pomerite se nagore da biste jedan pročitali i lista ostaje na mestu. Polje za filtriranje sužava listu; detalji poziva koriste tačno iste kartice odgovora kao i zahtevi (telo, informacije, kolačići, graf), protokol po protokol.

Prikaz snimaka: lista poziva grupisanih po izvršavanju levo, detalji izabranog poziva desno sa njegovim karticama odgovora

Kontekstni meni poziva nudi njegovo dodavanje na belu ili crnu listu, sa njegovim url-om unapred popunjenim kao obrascem. Novi obrazac možete primeniti i na već zabeležene pozive: oni koji više ne prolaze se uklanjaju, trajno — aplikacija traži potvrdu.

Broj poziva sačuvanih po sesiji je ograničen (podrazumevano 1.000, podesivo u podešavanjima aplikacije); preko te granice, najstariji se brišu.

Izvođenje ruta

Section titled “Izvođenje ruta”

Na planovima Pro i Enterprise, dugme Izvedi rute u prikazu snimaka pretvara pozive u stablo ispod reda „Rute” sesije:

  • pozivi se grupišu po ruti: segment putanje koji se menja od poziva do poziva (/pets/1, /pets/2) postaje parametar putanje {{petId}};
  • fascikle prate statičke prefikse putanja (api › pets); gRPC-web pozivi se razvrstavaju po servisu;
  • svaka ruta postaje običan zahtev — HTTP, GraphQL, gRPC-web ili WebSocket — unapred popunjen iz poslednjeg uspešnog poziva (zaglavlja, parametri, telo) i odmah spreman za ponovno izvršavanje;
  • zabeleženi pozivi se upisuju u istoriju odgovora svakog zahteva, u uobičajenom formatu i u okviru podešene granice čuvanja; podrazumevano prikazani odgovor je odgovor poslednjeg uspešnog poziva.

Razvijen red Rute sesije: izvedene fascikle i njihovi zahtevi, spremni za ponovno izvršavanje

Ponovno pokretanje izvođenja nakon novih snimanja spaja: dodaju se samo nove rute, a postojeći zahtevi — uključujući one koje ste izmenili — ostaju netaknuti.

Na planu Community, snimanje i pregled snimaka su u potpunosti dostupni; kartica Rute prikazuje podsetnik o Pro funkcionalnosti.

Iz AI asistenta

Section titled “Iz AI asistenta”

Cela funkcionalnost je izložena preko MCP servera Restorma: kreiranje i podešavanje sesije, pokretanje i zaustavljanje snimanja, čitanje snimaka i izvođenje ruta. Agent tako može da otvori stranicu, pusti je da radi, a zatim vam preda fasciklu zahteva spremnih za upotrebu.