La oss først se hva skaperne av Postman selv sier:
«Postman er et kraftig sett med verktøy for å teste API-er, som mange utviklere ikke lenger klarer seg uten. Vi lager utmerkede produkter som hjelper til med å skape imponerende grensesnitt og arbeide mer produktivt. Postman brukes av mer enn en million utviklere i verden, og tallet vokser stadig. Vi har til hensikt å utvikle flere produkter for å gi utviklere den sterkeste løsningen for å lage og teste API-er.»
Den nåværende utgaven av Postman er enda kraftigere enn de gamle, og mange Pro-funksjoner er nå gratis. Mer enn det: dette verktøyet ble ikke laget bare for utviklere. Selv å prøve automatiske svar krever ingen særskilt kunnskap. Det er et svært enkelt og samtidig kraftig verktøy.
Sende en forespørsel
Åpner du dette settet, går til «Request Methods» og deretter til «GET Requests», vil alle lagrede data vises i midten av Postman-vinduet. Klikk nå «Submit». Du har nettopp sendt din første forespørsel og fått ditt første svar.
POST-forespørsler er litt vanskeligere, men fortsatt klare og logiske. Denne gangen bruker du din egen forespørsel. Klikk plusstegnet for å åpne en ny fane, endre forespørselstypen fra GET til POST og oppgi https://jsonplaceholder.typicode.com/posts som adresse for forespørselen. Dette er en gratis REST-tjeneste som kan brukes til oppdiktede data. Den er svært nyttig til å lære, etterligne en tjeners virkemåte og spre kodeeksempler.
Nå trenger du kroppen til POST-forespørselen. Klikk «Body» under adressen, endre typen til «raw» og «Text» til «JSON». Lim så inn denne forespørselen i redigeringsfeltet:
- {
- “title”: “My first POST request”,
- “body”: “Content of my first POST request!”,
- “userId”: 789
- }
Klikk «send». Du bør få et svar med din egen tekst — en bekreftelse på at forespørselen gikk gjennom. Lagre den til senere. Du kan også opprette en ny samling: klikk bare «Save» til høyre for adressen. Det åpnes et lagringsvindu der du kan gi forespørselen et navn og opprette en ny samling for den.
Kontroller
En annen flott mulighet i Postman er automatiske kontroller av forespørsler. Når du først har laget en kontroll for en forespørsel, prøver Postman hvert innkommende svar etter dine tilfeller. La oss se på et enkelt eksempel.
Legg til en ny egen forespørsel for å hente POST fra https://jsonplaceholder.typicode.com/posts med ID = 6, og åpne fanen «Tests». Til høyre i Postman-vinduet ser du en liste med utdrag. Den hjelper deg å skrive den første kontrollen, den andre og alle de neste, for denne koden passer til hva som helst — den trenger bare å tilpasses litt til dine behov.
tests[“Status code is 200”] = responseCode.code === 200;
- var jsonData = JSON.parse(responseBody);
- tests[“User ID is 1”] = jsonData.userId === 1;
- tests[“Post ID is 6”] = jsonData.id === 6;
- tests[“Body matches string”] = responseBody.has(“dolorem eum magni eos aperiam quia”);
- I den første kontrollen ser vi om svaret på forespørselen vår returnerer HTTP-statusen «200», om brukerens identifikator er 1 og innleggets identifikator 6, og om svarkroppen inneholder den ventede teksten.
Klikk nå ganske enkelt «Submit». Når svaret er kommet, åpner du fanen «Tests» og sjekker om alle er bestått.
Med denne artikkelen ville vi vise hvor enkelt og hyggelig det er å arbeide med Postman!