HTTP i REST

Najczęściej używany typ żądania: wszystko, co mówi w HTTP, począwszy od API REST.

Kliknięcie prawym przyciskiem w drzewie ▸ Dodaj ▸ Żądanie HTTP.

Metody

GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS i QUERY.

Adres URL

Adres URL przyjmuje {{variables}} w każdym miejscu — schemat, host, port, ścieżka, ciąg zapytania. Rozwiązana wartość jest wyświetlana pod polem.

Adres URL uzupełniają trzy listy:

• parametry zapytania (?clé=valeur);
• parametry ścieżki, które zastępują nazwane segmenty ścieżki;
• nagłówki.

Każdy wiersz ma pole wyboru włączające go, typ wartości oraz opis.

Treść

Cztery rodziny:

Typ	Zastosowanie
Tekst	JSON, XML, zwykły tekst — z kolorowaniem składni i formatowaniem
Plik	Wysyła zawartość pliku z dysku
Formularz (multipart/form-data)	Nazwane pola, także pliki
x-www-form-urlencoded	Nazwane pola zakodowane w treści

Opcje

• Limit czasu: w milisekundach, właściwy dla tego żądania; w razie jego braku obowiązuje wartość globalna.
• Podążaj za przekierowaniami: włączone domyślnie. Wyłączenie tej opcji pozwala obejrzeć samą odpowiedź 3xx wraz z jej nagłówkiem Location.

Odpowiedź

Status, czas, rozmiar, nagłówki oraz treść wyrenderowana zgodnie z jej typem zawartości: zwijana przeglądarka JSON, wcięty XML, podgląd obrazu, zwykły tekst. Zakładka historii daje dostęp do wcześniejszych wykonań.

Uwierzytelnianie

Dołączenie do żądania trasy uwierzytelniania sprawia, że nagłówki są wstrzykiwane, a token odnawiany automatycznie. Zob. Uwierzytelnianie.

Tryb serwera

Restorm może również hostować serwer HTTP, aby sprawdzić, w jaki sposób konsumuje go klient — zwykle jest to kod własnej aplikacji, którą na czas próby kieruje się na localhost.

Dodaje się go przez Dodaj ▸ Serwer HTTP: nasłuchuje na localhost:<port><path> dla pary metoda + ścieżka i odpowiada statusem, nagłówkami oraz treścią skonfigurowanymi w tym miejscu. Inne protokoły hostuje się w ten sam sposób — zob. Tryb serwera oraz Symulowanie API HTTP.

Fragmenty kodu

W zakładce Code Snippets dostępne są dwadzieścia cztery języki i biblioteki: cURL, JavaScript (Fetch, Axios), TypeScript, Python (Requests, http.client, aiohttp), natywny 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 zamiast wpisywania

Istnieje już specyfikacja OpenAPI, kolekcja Postmana, plik HAR albo zwykłe polecenie curl? Plik ▸ Importuj odtwarza całe drzewo. Zob. Import i eksport.