Hoe API's te debuggen met Postman

0
182

Postman is een programma en toolkit waarmee het werken met, ontwikkelen en debuggen API-services op afstand eenvoudiger. Het biedt een platform voor het maken, beheren en werken met GET- en POST-verzoeken.

Wat is Postman?

Postman beschrijft zichzelf als een “Platform voor API-ontwikkeling.” Op het meest basale niveau biedt het een eenvoudige GUI-interface voor interactie met externe API's. Het is in wezen een ultramoderne REST-client, ontworpen voor het werken met complexe API's.

Het is niet alleen een geweldige REST-client, maar biedt ook tools voor het beheren van verzamelingen van verzoeken. Met behulp van deze collecties en kennis van het API-schema kan het volledig geautomatiseerde API-tests uitvoeren, die kunnen worden geïntegreerd in CI/CD-pijplijnen om ervoor te zorgen dat eventuele codewijzigingen de API in productie niet verbreken.

Postbode gebruiken

Om te beginnen, testen we een basisverzoek. U kunt meerdere verzoeken opslaan in Collecties, die opnieuw kunnen worden gebruikt en gedeeld.

In Postman heeft elk verzoek zijn eigen tabblad in de werkruimte. U vindt bedieningselementen voor de verzoekinstellingen, evenals uitvoer van de server. Als je het op volledig scherm gebruikt, kun je het wisselen naar de kolommodus naast elkaar met de knop rechtsonder.

Advertentie

U kunt het verzoektype wijzigen in de vervolgkeuzelijst op de URL-balk. De meest gebruikelijke methoden zijn GET en POST, maar alle HTTP-werkwoorden worden volledig ondersteund.

< /p>

Onder de “Authenticatie” tabblad, moet u de auth-sleutels instellen voor de API die u gebruikt, tenzij deze openbaar is. Postman ondersteunt OAuth 1 en 2, evenals de meeste andere tokentypen naast Basic Auth.

Onder “Headers,” u kunt de koppen van het bericht instellen, zoals Content-Type. Veel hiervan worden automatisch ingesteld, wat u kunt bekijken onder de “Hidden” knop.

Voor de hoofdtekst van het verzoek kunt u formuliergegevens specificeren met behulp van sleutel-waardeparen, een binair pakket, een GraphQL-verzoek verzenden of gewoon onbewerkte JSON- of tekstgegevens verzenden. De editor bevat een ingebouwde JSON-editor en validator.

Een van de coolste dingen die je met Postman kunt doen, is het opzetten van API-tests. Deze zijn gecodeerd in JavaScript en worden uitgevoerd nadat het resultaat is ontvangen. U kunt meer lezen over het instellen ervan in de handleiding van Postman om ze te gebruiken

Zodra u uw verzoek heeft voorbereid, kunt u het testen met de “Send” knop. U zou een reactie moeten krijgen van de externe server, die u kunt bekijken in Pretty-print, HTML-preview of gewoon onbewerkte uitvoer. U kunt verschillende statistieken zien, zoals de HTML-responscode, payload-grootte en ping, in de statusbalk boven de

Advertentie

Je kunt ook de vervolgkeuzelijst van “Body” naar “Koptekst” om de headers te bekijken die de API heeft geretourneerd.

Met de JavaScript-testers kunt u ook eenvoudige gegevensvisualisaties maken, zoals taart- en staafdiagrammen, die handig kunnen zijn om veel gegevens te begrijpen.< /p>

Als je erop terug wilt komen , of sla de test op, u kunt deze opslaan in een “Collectie.” U kunt dan de Collection Runner in de bovenste menubalk gebruiken om alle verzoeken en tests in de verzameling uit te voeren, die kunnen worden gebruikt om alle API-eindpunten te testen.