Sesionet e regjistrimit

Një sesion regjistrimi vëzhgon një faqe ueb ndërkohë që ju e përdorni dhe shënon çdo thirrje API që ajo kryen: REST, GraphQL, gRPC-web dhe WebSocket. Thirrjet e kapura shfletohen si përgjigje të zakonshme dhe, në planet Pro dhe Enterprise, shndërrohen në një dosje me kërkesa të vërteta, të riluajtshme, të plotësuara paraprakisht me atë që faqja ka dërguar në të vërtetë.

Është rruga më e shkurtër për të dokumentuar një API nga e cila keni vetëm front-end-in: asnjë proxy për të konfiguruar, asnjë certifikatë për të instaluar, asnjë shtesë shfletuesi.

Krijimi i një sesioni

Një sesion krijohet kudo në pemë — në rrënjë, në një dosje ose në një dosje mjedisi — nga menyja kontekstuale („Shto” → „Sesion regjistrimi”) ose nga menyja „Krijo”; vetëm një skenar nuk mund të përmbajë një të tillë. Ai shfaqet në shiritin anësor si nyje prind: faqja e konfigurimit hapet me një klikim mbi vetë sesionin, ndërsa secila nga rreshtat e tij fëmijë hap skedën e vet.

Faqja e konfigurimit të një sesioni regjistrimi: url-ja e faqes, protokollet që kapen, lista e bardhë dhe lista e zezë, dhe butoni Nis regjistrimin

Konfigurimi përmblidhet në katër elemente:

Url-ja e faqes që do të hapet në mini-shfletues (http://, https:// ose file://). Butoni „Nis regjistrimin” mbetet i çaktivizuar për sa kohë url-ja nuk është e vlefshme.
Protokollet që do të kapen: HTTP, WebSocket, GraphQL, gRPC-web — të gjitha të shënuara si parazgjedhje.
Lista e bardhë: shprehje të rregullta; një thirrje ruhet nëse përputhet me të paktën njërën prej tyre. E zbrazët, ajo lë gjithçka të kalojë.
Lista e zezë: shprehje të rregullta; një thirrje që përputhet me njërën prej tyre hidhet poshtë. Lista e zezë ka gjithmonë fjalën e fundit.

Vetëm këto cilësime dhe rrugët e nxjerra ruhen në skedarin e projektit. Thirrjet e kapura, nga ana tjetër, mbeten në memorie: zhduken me mbylljen e projektit dhe nuk shkruhen kurrë në disk.

Regjistrimi

Butoni „Nis regjistrimin” hap faqen në një skedë të mini-shfletuesit dhe lidh regjistruesin përpara ngarkimit të parë, kështu që thirrjet që faqja kryen gjatë nisjes — përfshirë një lidhje WebSocket të hapur menjëherë — kapen. Një aureolë pulsuese rreth shenjës së sesionit në shiritin anësor, dhe rreth skedës së tij, tregon që regjistrimi është në vazhdim.

Mini-shfletuesi gjatë një regjistrimi: faqja e sajtit, butonat Ndalo përkohësisht regjistrimin dhe Ndal regjistrimin në rreshtin e adresës, shenja e kuqe mbi sesionin

Lundroni dhe përdorni faqen si zakonisht. Dy butona në rreshtin e adresës kontrollojnë sesionin:

Ndalo përkohësisht regjistrimin e mban faqen të hapur, por nuk ruan më thirrjet — praktike për të kaluar një ekran pa interes.
Ndal regjistrimin shkëput regjistruesin dhe mbyll skedën e shfletuesit. Kapjet mbeten të disponueshme.

Një regjistrim është gjithmonë një veprim i qëllimshëm: një skedë shfletuesi e rikthyer me rihapjen e aplikacionit nuk regjistron asgjë.

Sajtet që kanë nevojë për vendndodhjen tuaj ia kërkojnë atë shfletuesit, dhe si parazgjedhje mini-shfletuesi nuk zbulon asgjë. Cilësimi Ndani vendndodhjen tuaj me shfletuesin e integruar, në seksionin Privatësia të cilësimeve të aplikacionit dhe i çaktivizuar si parazgjedhje, jep vendndodhjen tuaj të përafërt pasi kërkon pëlqimin tuaj — nga shërbimi i vendndodhjes i sistemit, përndryshe nga një vlerësim në nivel qyteti bazuar në adresën tuaj IP. Çaktivizimi i tij e harron vendndodhjen menjëherë.

Kapjet

Rreshti „Kapjet” i sesionit hap pamjen e thirrjeve, të grupuara sipas ekzekutimit nga më i vjetri te më i riu dhe të përditësuara drejtpërdrejt gjatë regjistrimit. Për sa kohë lista është lëvizur deri në fund, ajo ndjek thirrjet më të reja; ngjituni lart për të lexuar një prej tyre dhe lista nuk lëviz më. Një fushë filtri ngushton listën; detaji i një thirrjeje ripërdor saktësisht skedat e përgjigjes të kërkesave (trupi, informacionet, cookies, grafiku), protokoll pas protokolli.

Pamja e kapjeve: lista e thirrjeve të grupuara sipas ekzekutimit në të majtë, detaji i thirrjes së zgjedhur në të djathtë me skedat e saj të përgjigjes

Menyja kontekstuale e një thirrjeje ofron shtimin e saj në listën e bardhë ose në listën e zezë, me url-në e saj të plotësuar paraprakisht si model. Mund ta zbatoni modelin e ri edhe mbi thirrjet tashmë të kapura: ato që nuk kalojnë më fshihen, përfundimisht — aplikacioni kërkon konfirmim.

Numri i thirrjeve të ruajtura për sesion është i kufizuar (1.000 si parazgjedhje, i rregullueshëm në cilësimet e aplikacionit); përtej këtij kufiri, më të vjetrat fshihen.

Nxjerrja e rrugëve

Në planet Pro dhe Enterprise, butoni Nxirr rrugët i pamjes së kapjeve shndërron thirrjet në një pemë nën rreshtin „Rrugët” të sesionit:

thirrjet grupohen sipas rrugës: një segment shtegu që ndryshon nga një thirrje në tjetrën (/pets/1, /pets/2) bëhet parametër shtegu {{petId}};
dosjet ndjekin prefikset statike të shtigjeve (api › pets); thirrjet gRPC-web sistemohen sipas shërbimit;
çdo rrugë bëhet një kërkesë e zakonshme — HTTP, GraphQL, gRPC-web ose WebSocket — e plotësuar paraprakisht nga thirrja e fundit e suksesshme (headers, parametra, trup) dhe e riluajtshme menjëherë;
thirrjet e kapura derdhen në historikun e përgjigjeve të secilës kërkesë, në formatin e zakonshëm dhe brenda kufirit të ruajtjes të konfiguruar; përgjigjja që shfaqet si parazgjedhje është ajo e thirrjes së fundit të suksesshme.

Rreshti Rrugët i sesionit i shpalosur: dosjet e nxjerra dhe kërkesat e tyre, gati për t’u riluajtur

Rinisja e nxjerrjes pas regjistrimeve të reja bashkon: shtohen vetëm rrugët e reja, ndërsa kërkesat ekzistuese — përfshirë ato që i keni ndryshuar vetë — mbeten të paprekura.

Në planin Community, regjistrimi dhe shfletimi i kapjeve janë plotësisht të disponueshme; skeda Rrugët shfaq një kujtesë për funksionalitetin Pro.

Nga një asistent IA

I gjithë funksionaliteti ekspozohet nga serveri MCP i Restorm: krijimi dhe konfigurimi i një sesioni, nisja dhe ndalimi i regjistrimit, leximi i kapjeve dhe nxjerrja e rrugëve. Një agjent mund kështu të hapë një faqe, ta lërë të punojë dhe më pas t’ju dorëzojë një dosje me kërkesa gati për përdorim.