HTTP és REST

A leggyakoribb kéréstípus: mindaz, ami HTTP-t beszél, elsősorban a REST API-k.

Jobb kattintás a projektfában ▸ Hozzáadás ▸ HTTP-kérés.

Metódusok

GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS és QUERY.

Az URL

Az URL mindenhol elfogad {{variables}} hivatkozásokat — séma, hoszt, port, útvonal, lekérdezési karakterlánc. A feloldott érték a mező alatt látható.

Az URL-t három lista egészíti ki:

• a lekérdezési paraméterek (?clé=valeur);
• az útvonal-paraméterek, amelyek az útvonal elnevezett szegmenseit helyettesítik;
• a fejlécek.

Minden sorhoz tartozik egy engedélyező jelölőnégyzet, egy értéktípus és egy leírás.

A törzs

Négy család:

Típus	Felhasználás
Szöveg	JSON, XML, egyszerű szöveg — szintaxiskiemeléssel és újraformázással
Fájl	A lemezen lévő fájl tartalmát küldi el
Űrlap (multipart/form-data)	Elnevezett mezők, fájlokkal is
x-www-form-urlencoded	A törzsbe kódolt elnevezett mezők

Beállítások

• Időkorlát: milliszekundumban, csak erre a kérésre érvényes; ha nincs megadva, a globális érték lép életbe.
• Átirányítások követése: alapértelmezés szerint bekapcsolva. Kikapcsolásával maga a 3xx válasz és annak Location fejléce is megvizsgálható.

A válasz

Állapotkód, idő, méret, fejlécek, valamint a tartalomtípusának megfelelően megjelenített törzs: összecsukható JSON-megjelenítő, behúzott XML, képelőnézet, egyszerű szöveg. Az előzmények lapról a korábbi futtatások is elérhetők.

Hitelesítés

A kéréshez hitelesítési útvonal csatolható, így a fejlécek automatikusan beszúródnak, a token pedig magától megújul. Lásd: Hitelesítés.

Kiszolgálómód

A Restorm HTTP-kiszolgálót is képes üzemeltetni, hogy megvizsgálható legyen, hogyan használja azt egy kliens — jellemzően a saját alkalmazás kódja, amelyet a próba idejére a localhost címre kell irányítani.

Ilyen kiszolgáló a Hozzáadás ▸ HTTP-kiszolgáló paranccsal adható hozzá: egy metódus + útvonal páros esetén a localhost:<port><path> címen figyel, és az ott beállított állapotkóddal, fejlécekkel és törzzsel válaszol. A többi protokoll ugyanígy üzemeltethető — lásd: Kiszolgálómód és HTTP-API szimulálása.

Kódrészletek

A Code Snippets lapon huszonnégy nyelv és könyvtár közül lehet választani: cURL, JavaScript (Fetch, Axios), TypeScript, Python (Requests, http.client, aiohttp), natív Node.js, Go, Rust (reqwest), Java (HttpClient, OkHttp), C# (HttpClient), PHP (cURL, Guzzle), Ruby (Net::HTTP, Faraday), Swift (URLSession), Kotlin (OkHttp), Dart, R (httr), PowerShell, Elixir (HTTPoison), Clojure (clj-http).

Importálás kézi bevitel helyett

Van már OpenAPI-specifikáció, Postman-gyűjtemény, HAR-fájl vagy egy egyszerű curl parancs? A Fájl ▸ Importálás felépíti belőle a teljes projektfát. Lásd: Import és export.