Wat is een HTTP-client?

Een HTTP-client verstuurt verzoeken naar een webserver of API en toont wat er terugkomt. Ontwikkelaars gebruiken een HTTP-client om een endpoint uit te proberen voordat ze er code voor schrijven, te controleren of een API de juiste status en gegevens retourneert, een bug te reproduceren of te bekijken welke headers een server verstuurt. Desktopapps zoals Postman, Insomnia en Yaak, en de curl-opdrachtregeltool zijn de bekendste voorbeelden.

Beschrijving van de tool

Deze tool is een lichtgewicht HTTP-client die in je browser draait en waarvoor je niets hoeft te installeren. Kies een methode, voer een URL in, voeg queryparameters, headers, een body en inloggegevens toe en klik op Verzenden. De response toont de statuscode, tijd, grootte, headers en body, waarbij JSON overzichtelijk wordt opgemaakt. Je kunt ook een curl-opdracht plakken om het volledige verzoek in te vullen, of elk verzoek als curl-opdracht kopiëren.

Functies

  • GET-, POST-, PUT-, PATCH-, DELETE-, HEAD- en OPTIONS-verzoeken
  • Queryparameters die synchroon blijven met de URL, zodat je beide kunt bewerken
  • Aangepaste headers, met een waarschuwing voor headers die browsers niet versturen
  • JSON-, XML-, platte tekst- en URL-gecodeerde formulierbodies, waarbij Content-Type automatisch voor je wordt ingesteld
  • Bearer token- en basisverificatie
  • Status, tijd, grootte, headers en body van de response, waarbij JSON overzichtelijk wordt opgemaakt
  • Afbeeldingsresponses worden als voorbeeldweergave getoond en elke response kan als bestand worden gedownload
  • Een verzoek importeren door een curl-opdracht te plakken, inclusief ‘Kopiëren als cURL’ in de ontwikkelaarstools van de browser
  • Het huidige verzoek exporteren als curl-opdracht

Hoe het werkt

De tool verstuurt je verzoek met de eigen fetch API van de browser, rechtstreeks vanaf je apparaat naar de server, zodat er niets via onze servers gaat. De beveiligingsregels van de browser zijn echter van toepassing. Een verzoek naar een andere website krijgt alleen een leesbare response wanneer die server dit toestaat via CORS (Cross-Origin Resource Sharing). De meeste openbare API's doen dit, maar veel private API's niet. De browser weigert ook om een webpagina bepaalde headers te laten instellen, zoals Cookie, Host, Origin en User-Agent, en toont alleen de response-headers die de server kiest om beschikbaar te stellen. Pagina's die via https:// worden aangeboden, kunnen geen plain http://-adressen aanroepen, behalve localhost in de meeste browsers.

Tips

  • Als een verzoek mislukt zonder response, open dan de ontwikkelaarsconsole van je browser: daarin staat de reden, die meestal een ontbrekende Access-Control-Allow-Origin-header op de server is.
  • Als je je eigen API wilt testen, sta dan de origin van deze site toe in de CORS-instellingen of test de API op localhost.
  • Een verzoek waarvoor cookies nodig zijn of waarvoor een IP-adres nodig is dat alleen een server heeft, kun je beter met curl versturen. Kopieer het verzoek uit het cURL-tabblad en voer het uit in een terminal.
  • Druk op Enter in het URL-veld om het verzoek te versturen.
  • Laat het schema weg en de tool voegt https:// toe, of http:// voor localhost en 127.0.0.1.
  • Voeg een API-sleutel als header toe, bijvoorbeeld X-Api-Key, in het tabblad Headers.