Tovább a tartalomhoz

Felvételi munkamenetek

A felvételi munkamenet figyeli a weboldalt, miközben Ön használja, és feljegyzi minden API-hívását: REST, GraphQL, gRPC-web és WebSocket. A rögzített hívások közönséges válaszokként tekinthetők meg, a Pro és Enterprise csomagokban pedig valódi, újra futtatható kérések mappájává alakulnak, előre kitöltve azzal, amit az oldal ténylegesen elküldött.

Ez a legrövidebb út egy olyan API dokumentálásához, amelyből csak a front-end áll rendelkezésére: nincs beállítandó proxy, nincs telepítendő tanúsítvány, nincs böngészőbővítmény.

A munkamenet a fa bármely pontján létrehozható — a gyökérben, egy mappában vagy egy környezeti mappában — a helyi menüből („Hozzáadás” → „Felvételi munkamenet”) vagy a „Létrehozás” menüből; csak egy forgatókönyv nem tartalmazhat ilyet. Az oldalsávban szülőelemként jelenik meg: magára a munkamenetre kattintva a beállítási oldala nyílik meg, gyermeksorai pedig külön-külön saját lapot nyitnak.

Egy felvételi munkamenet beállítási oldala: az oldal url-je, a rögzített protokollok, a fehérlista és a feketelista, valamint a Felvétel indítása gomb

A beállítás négy elemből áll:

  • Az oldal url-je, amelyet a miniböngésző megnyit (http://, https:// vagy file://). A Felvétel indítása gomb letiltva marad, amíg az url nem érvényes.
  • A rögzítendő protokollok: HTTP, WebSocket, GraphQL, gRPC-web — alapértelmezés szerint mind be van jelölve.
  • A fehérlista: reguláris kifejezések; egy hívás akkor marad meg, ha legalább egyikükre illeszkedik. Üresen mindent átenged.
  • A feketelista: reguláris kifejezések; a bármelyikükre illeszkedő hívás elvetésre kerül. A feketelistáé mindig az utolsó szó.

A projektfájlba csak ezek a beállítások és a levezetett útvonalak kerülnek mentésre. A rögzített hívások a memóriában maradnak: a projekt bezárásakor eltűnnek, és soha nem íródnak lemezre.

A Felvétel indítása gomb megnyitja az oldalt egy miniböngésző-lapon, és még az első betöltés előtt csatolja a rögzítőt, így az oldal indulásakor végzett hívások — köztük egy azonnal megnyitott WebSocket-kapcsolat — is rögzítésre kerülnek. A munkamenet jelvénye körül az oldalsávban, valamint a lapja körül pulzáló fénykör jelzi, hogy a felvétel folyamatban van.

A miniböngésző felvétel közben: a webhely oldala, a Felvétel szüneteltetése és a Felvétel leállítása gombok a címsorban, a piros jelvény a munkameneten

Navigáljon és használja az oldalt a megszokott módon. A munkamenetet a címsor két gombja vezérli:

  • Felvétel szüneteltetése: az oldal nyitva marad, de a hívások tárolása leáll — praktikus egy érdektelen képernyő átugrásához.
  • Felvétel leállítása: leválasztja a rögzítőt és bezárja a böngészőlapot. A rögzítések elérhetők maradnak.

A felvétel mindig kifejezett művelet: az alkalmazás újranyitásakor visszaállított böngészőlap semmit nem rögzít.

Az Ön tartózkodási helyét igénylő webhelyek a böngészőtől kérik azt, és a miniböngésző alapértelmezés szerint semmit nem árul el. A Tartózkodási hely megosztása a beágyazott böngészővel beállítás, az alkalmazás beállításainak Adatvédelem szakaszában és alapértelmezés szerint kikapcsolva, az Ön hozzájárulásának kérése után adja meg hozzávetőleges tartózkodási helyét — a rendszer helymeghatározó szolgáltatásából, ennek hiányában az Ön IP-címe alapján készült, városszintű becslésből. Kikapcsolása azonnal elfelejti a pozíciót.

A munkamenet „Rögzítések” sora megnyitja a hívások nézetét, futtatás szerint, a legrégebbitől a legújabbig csoportosítva és felvétel közben élőben frissítve. Amíg a lista teljesen le van görgetve, követi a legújabb hívásokat; görgessen fel egy hívás elolvasásához, és a lista a helyén marad. Egy szűrőmező szűkíti a listát; egy hívás részletei pontosan a kérések válaszlapjait használják újra (törzs, információk, cookie-k, gráf), protokollonként.

A rögzítések nézete: bal oldalon a futtatás szerint csoportosított hívások listája, jobb oldalon a kijelölt hívás részletei a válaszlapjaival

Egy hívás helyi menüje felajánlja a fehérlistához vagy a feketelistához adását, url-jével mintaként előre kitöltve. Az új mintát a már rögzített hívásokra is alkalmazhatja: amelyek már nem mennek át, véglegesen törlődnek — az alkalmazás megerősítést kér.

A munkamenetenként megőrzött hívások száma korlátozott (alapértelmezés szerint 1 000, az alkalmazás beállításaiban módosítható); ezen felül a legrégebbiek törlődnek.

A Pro és Enterprise csomagokban a rögzítések nézetének Útvonalak levezetése gombja a hívásokat fastruktúrává alakítja a munkamenet „Útvonalak” sora alatt:

  • a hívások útvonal szerint csoportosulnak: a hívásról hívásra változó útvonalszegmens (/pets/1, /pets/2) {{petId}} útvonalparaméterré válik;
  • a mappák az útvonalak statikus előtagjait követik (api › pets); a gRPC-web hívások szolgáltatás szerint kerülnek besorolásra;
  • minden útvonal közönséges kéréssé válik — HTTP, GraphQL, gRPC-web vagy WebSocket —, az utolsó sikeres hívásból előre kitöltve (fejlécek, paraméterek, törzs), és azonnal újra futtatható;
  • a rögzített hívások minden kérés válaszelőzményeibe kerülnek, a megszokott formátumban és a beállított megőrzési korláton belül; alapértelmezés szerint az utolsó sikeres hívás válasza jelenik meg.

A munkamenet kibontott Útvonalak sora: a levezetett mappák és kéréseik, készen az újrafuttatásra

A levezetés újbóli futtatása újabb felvételek után összefésül: csak az új útvonalak adódnak hozzá, a meglévő kérések — beleértve az Ön által módosítottakat is — érintetlenek maradnak.

A Community csomagban a felvétel és a rögzítések megtekintése teljes körűen elérhető; az Útvonalak lap a Pro funkcióra hívja fel a figyelmet.

A teljes funkció elérhető a Restorm MCP-kiszolgálóján keresztül: munkamenet létrehozása és beállítása, a felvétel indítása és leállítása, a rögzítések olvasása és az útvonalak levezetése. Egy ügynök így megnyithat egy oldalt, futni hagyhatja, majd átadhat egy használatra kész kéréseket tartalmazó mappát.