Che cos'è un client HTTP?

Un client HTTP invia richieste a un server web o a un'API e mostra ciò che riceve. Gli sviluppatori lo usano per provare un endpoint prima di scrivere codice che lo utilizzi, verificare che un'API restituisca lo stato e i dati corretti, riprodurre un bug o vedere quali intestazioni invia un server. Le app desktop come Postman, Insomnia e Yaak e lo strumento da riga di comando curl sono gli esempi più noti.

Descrizione dello strumento

Questo strumento è un client HTTP leggero che viene eseguito nel browser e non richiede installazione. Scegli un metodo, inserisci un URL, aggiungi parametri di query, intestazioni, un corpo e le credenziali, quindi premi Invia. La risposta mostra il codice di stato, il tempo, le dimensioni, le intestazioni e il corpo, con il JSON formattato per facilitarne la lettura. Puoi anche incollare un comando curl per compilare l'intera richiesta oppure copiare qualsiasi richiesta come comando curl.

Funzionalità

  • Richieste GET, POST, PUT, PATCH, DELETE, HEAD e OPTIONS
  • Parametri di query sincronizzati con l'URL, così puoi modificare l'uno o l'altro
  • Intestazioni personalizzate, con un avviso per quelle che i browser non inviano
  • Corpi del modulo in JSON, XML, testo semplice e codificati nell'URL, con il Content-Type impostato automaticamente
  • Autenticazione con token Bearer e autenticazione di base
  • Stato, tempo, dimensioni, intestazioni e corpo della risposta, con il JSON formattato
  • Risposte contenenti immagini mostrate come anteprima e qualsiasi risposta scaricabile come file
  • Importazione di una richiesta incollando un comando curl, incluso Copia come cURL dagli strumenti per sviluppatori del browser
  • Esportazione della richiesta corrente come comando curl

Come funziona

Lo strumento invia la tua richiesta utilizzando l'API fetch del browser, direttamente dal tuo dispositivo al server, quindi nulla passa attraverso i nostri server. Tuttavia, si applicano le regole di sicurezza del browser. Una richiesta a un altro sito web riceve una risposta leggibile solo quando quel server consente l'accesso tramite CORS (condivisione di risorse tra origini diverse), cosa che fanno la maggior parte delle API pubbliche, ma non molte API private. Il browser impedisce inoltre a una pagina web di impostare alcune intestazioni, come Cookie, Host, Origin e User-Agent, e mostra solo le intestazioni della risposta che il server sceglie di rendere disponibili. Le pagine pubblicate su https:// non possono chiamare indirizzi http:// semplici, ad eccezione di localhost nella maggior parte dei browser.

Suggerimenti

  • Se una richiesta non va a buon fine senza restituire alcuna risposta, apri la console per sviluppatori del browser: indica il motivo, che di solito è un'intestazione Access-Control-Allow-Origin mancante sul server.
  • Per testare la tua API, consenti l'origine di questo sito nelle impostazioni CORS oppure esegui il test su localhost.
  • Una richiesta che richiede cookies o un indirizzo IP disponibile solo a un server è meglio inviarla con curl. Copiala dalla scheda cURL ed eseguila in un terminale.
  • Premi Invio nel campo URL per inviare la richiesta.
  • Ometti lo schema: lo strumento aggiungerà https:// oppure http:// per localhost e 127.0.0.1.
  • Per una chiave API, aggiungila come intestazione, ad esempio X-Api-Key, nella scheda Intestazioni.