Tallennusistunnot

Tallennusistunto tarkkailee verkkosivua, kun käytätte sitä, ja kirjaa jokaisen sivun tekemän API-kutsun: REST, GraphQL, gRPC-web ja WebSocket. Kaapattuja kutsuja tarkastellaan kuin tavallisia vastauksia, ja Pro- ja Enterprise-tilauksissa niistä muodostuu kansio oikeita, uudelleen suoritettavia pyyntöjä, jotka on esitäytetty sillä, mitä sivu todella lähetti.

Se on lyhin tie dokumentoida API, josta teillä on käytettävissä vain käyttöliittymä: ei välityspalvelinta määritettäväksi, ei varmennetta asennettavaksi, ei selainlaajennusta.

Istunnon luominen

Istunto luodaan mihin tahansa puussa — juureen, kansioon tai ympäristökansioon — pikavalikosta (”Lisää” → ”Tallennusistunto”) tai ”Luo”-valikosta; vain skenaario ei voi sisältää sellaista. Se näkyy sivupalkissa yläsolmuna: istuntoa itseään napsauttamalla avautuu sen asetussivu, ja kukin sen alirivi avaa oman välilehtensä.

Tallennusistunnon asetussivu: sivun osoite, kaapattavat protokollat, sallittujen ja estettyjen luettelot sekä Aloita tallennus -painike

Asetukset koostuvat neljästä osasta:

Sivun osoite, joka avataan miniselaimessa (http://, https:// tai file://). Aloita tallennus -painike pysyy poissa käytöstä, kunnes osoite on kelvollinen.
Kaapattavat protokollat: HTTP, WebSocket, GraphQL, gRPC-web — kaikki valittuina oletuksena.
Sallittujen luettelo: säännöllisiä lausekkeita; kutsu säilytetään, jos se vastaa vähintään yhtä niistä. Tyhjänä se päästää kaiken läpi.
Estettyjen luettelo: säännöllisiä lausekkeita; kutsu, joka vastaa jotakin niistä, hylätään. Estettyjen luettelolla on aina viimeinen sana.

Projektitiedostoon tallennetaan vain nämä asetukset ja päätellyt reitit. Kaapatut kutsut sen sijaan pysyvät muistissa: ne häviävät, kun projekti suljetaan, eikä niitä kirjoiteta koskaan levylle.

Tallentaminen

Aloita tallennus -painike avaa sivun miniselaimen välilehdelle ja kytkee tallentimen ennen ensimmäistä latausta, jotta sivun käynnistyessä tekemät kutsut — mukaan lukien heti avattu WebSocket-yhteys — saadaan kaapattua. Sykkivä hehku istunnon merkin ympärillä sivupalkissa ja sen välilehden ympärillä osoittaa, että tallennus on käynnissä.

Miniselain tallennuksen aikana: sivuston sivu, Keskeytä tallennus- ja Lopeta tallennus -painikkeet osoiterivillä, punainen merkki istunnon kohdalla

Selatkaa ja käyttäkää sivua tavalliseen tapaan. Kaksi osoiterivin painiketta ohjaavat istuntoa:

Keskeytä tallennus pitää sivun auki mutta lakkaa tallentamasta kutsuja — kätevä, kun haluatte ohittaa merkityksettömän näkymän.
Lopeta tallennus irrottaa tallentimen ja sulkee selaimen välilehden. Kaappaukset jäävät käytettäviksi.

Tallennus on aina nimenomainen toimenpide: sovelluksen uudelleenavauksessa palautettu selainvälilehti ei tallenna mitään.

Sivustot, jotka tarvitsevat sijaintianne, pyytävät sitä selaimelta, eikä miniselain oletuksena paljasta mitään. Asetus Sijaintinne jakaminen upotetun selaimen kanssa, sovelluksen asetusten Yksityisyys-osiossa ja oletuksena pois päältä, antaa likimääräisen sijaintinne pyydettyään ensin suostumuksenne — järjestelmän paikannuspalvelusta, tai sen puuttuessa kaupungin tarkkuudella IP-osoitteenne perusteella tehdystä arviosta. Sen poiskytkentä unohtaa sijainnin välittömästi.

Kaappaukset

Istunnon ”Kaappaukset”-rivi avaa kutsunäkymän, jossa kutsut on ryhmitelty suorituskerran mukaan vanhimmasta uusimpaan ja jota päivitetään tallennuksen aikana reaaliajassa. Kun luettelo on vieritetty aivan alas, se seuraa uusimpia kutsuja; vierittäkää ylös lukeaksenne jonkin niistä, ja luettelo pysyy paikallaan. Suodatuskenttä rajaa luetteloa; kutsun tiedot käyttävät täsmälleen samoja vastausvälilehtiä kuin pyynnöt (sisältö, tiedot, evästeet, kaavio), protokolla kerrallaan.

Kaappausnäkymä: vasemmalla suorituskerran mukaan ryhmitelty kutsuluettelo, oikealla valitun kutsun tiedot vastausvälilehtineen

Kutsun pikavalikko tarjoaa sen lisäämistä sallittujen tai estettyjen luetteloon, ja kutsun osoite on esitäytetty kuvioksi. Voitte soveltaa uutta kuviota myös jo kaapattuihin kutsuihin: ne, jotka eivät enää pääse läpi, poistetaan pysyvästi — sovellus pyytää vahvistuksen.

Istuntoa kohden säilytettävien kutsujen määrä on rajattu (oletuksena 1 000, säädettävissä sovelluksen asetuksissa); rajan ylittyessä vanhimmat poistuvat.

Reittien päättely

Pro- ja Enterprise-tilauksissa kaappausnäkymän Päättele reitit -painike muuntaa kutsut puuksi istunnon ”Reitit”-rivin alle:

kutsut ryhmitellään reitin mukaan: polun osa, joka vaihtelee kutsusta toiseen (/pets/1, /pets/2), muuttuu polkuparametriksi {{petId}};
kansiot seuraavat polkujen kiinteitä etuliitteitä (api › pets); gRPC-web-kutsut järjestetään palvelun mukaan;
jokaisesta reitistä tulee tavallinen pyyntö — HTTP, GraphQL, gRPC-web tai WebSocket — joka on esitäytetty viimeisimmän onnistuneen kutsun perusteella (otsakkeet, parametrit, sisältö) ja heti uudelleen suoritettava;
kaapatut kutsut viedään kunkin pyynnön vastaushistoriaan tavallisessa muodossa ja määritetyn säilytysrajan puitteissa; oletuksena näytetään viimeisimmän onnistuneen kutsun vastaus.

Istunnon Reitit-rivi avattuna: päätellyt kansiot ja niiden pyynnöt valmiina uudelleen suoritettaviksi

Päättelyn uusiminen uusien tallennusten jälkeen yhdistää: vain uudet reitit lisätään, ja olemassa olevat pyynnöt — myös ne, joita olette muokanneet — pysyvät koskemattomina.

Community-tilauksessa tallennus ja kaappausten tarkastelu ovat kokonaan käytettävissä; Reitit-välilehti näyttää muistutuksen Pro-ominaisuudesta.

Tekoälyavustajasta

Koko ominaisuus on käytettävissä Restormin MCP-palvelimen kautta: istunnon luominen ja määrittäminen, tallennuksen aloittaminen ja lopettaminen, kaappausten lukeminen ja reittien päättely. Agentti voi siten avata sivun, antaa sen pyöriä ja luovuttaa sitten kansion käyttövalmiita pyyntöjä.