HTTP e REST

È il tipo di richiesta più diffuso: tutto ciò che parla HTTP, a partire dalle API REST.

Clic destro nell’albero ▸ Aggiungi ▸ Richiesta HTTP.

Metodi

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

L’URL

L’URL accetta {{variables}} in ogni punto — schema, host, porta, percorso, stringa di query. Il valore risolto è mostrato sotto il campo.

Tre elenchi completano l’URL:

• i parametri di query (?chiave=valore);
• i parametri di percorso, che sostituiscono i segmenti denominati del percorso;
• gli header.

Ogni riga ha una casella di attivazione, un tipo di valore e una descrizione.

Il corpo

Quattro famiglie:

Tipo	Uso
Testo	JSON, XML, testo semplice — con evidenziazione della sintassi e riformattazione
File	Invia il contenuto di un file del disco
Form (multipart/form-data)	Campi denominati, con file
x-www-form-urlencoded	Campi denominati codificati nel corpo

Opzioni

• Timeout: in millisecondi, specifico di questa richiesta; in mancanza, si applica il valore globale.
• Segui i reindirizzamenti: attivo per impostazione predefinita. Si può disattivare per osservare il 3xx stesso e il suo header Location.

La risposta

Stato, tempo, dimensione, header e il corpo reso in base al tipo di contenuto: visualizzatore JSON richiudibile, XML indentato, anteprima di immagine, testo semplice. La scheda della cronologia dà accesso alle esecuzioni precedenti.

Autenticazione

Collegando una rotta di autenticazione alla richiesta, gli header vengono iniettati e il token rinnovato automaticamente. Si veda Autenticazione.

Modalità server

Restorm può anche ospitare un server HTTP, per verificare il modo in cui un client lo consuma — tipicamente il codice della propria applicazione, che si punta su localhost per la durata di una prova.

Se ne aggiunge uno con Aggiungi ▸ Server HTTP: ascolta su localhost:<port><path> per una coppia metodo + percorso e risponde con lo stato, gli header e il corpo che vi si configurano. Altri protocolli si ospitano nello stesso modo — si vedano Modalità server e Simulare un’API HTTP.

Snippet di codice

Nella scheda Code Snippets sono proposti ventiquattro linguaggi e librerie: cURL, JavaScript (Fetch, Axios), TypeScript, Python (Requests, http.client, aiohttp), Node.js nativo, 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).

Importare invece di digitare

Ha già una specifica OpenAPI, una collezione Postman, un file HAR o un semplice comando curl? File ▸ Importa ricostruisce l’albero al posto suo. Si veda Import & export.