POSTMAN-veiledning: API-testing ved hjelp av POSTMAN

postman tutorial api testing using postman

Denne trinnvise veiledningen forklarer API-testing ved hjelp av POSTMAN, inkludert grunnleggende om POSTMAN, dets komponenter og prøveforespørsel og svar:

Vi så på de vanligste spørsmålene ASP.Net og Web API intervju spørsmål i vår forrige opplæring. Ved å gå gjennom denne veiledningen, vil du lære hvordan vi nærmer oss API-testing gjennom POSTMAN for en gitt URL.

Postman er et veldig enkelt og intuitivt API-testverktøy eller -applikasjon. Hver komponent i POSTMAN er veldig viktig, siden den har sin egen betydning.

=> Les gjennom hele API-testserien her .

hvordan åpne bin filer på android

Liste over alle opplæringsveiledningene i denne serien

Opplæring # 1: Postman Introduction (Denne veiledningen)
Opplæring # 2: Hvordan bruke postbud for å teste Diff API-formater
Opplæring # 3: Postbud: Variable Scopes And Environment Files
Opplæring # 4: Postboksamlinger: Importer, eksporter og generer kodeprøver
Opplæring # 5: Automatisering av svarvalideringer med påstander
Opplæring # 6: Postbud: Forespørsel og innleggsforespørsel
Opplæring # 7: Postman Advanced Scripting
Opplæring # 8: Postbud - Integrering av kommandolinjen med Newman
Opplæring # 9: Postbud - Rapporteringsmaler med Newman
Opplæring # 10: Postman - Opprette API-dokumentasjon
Opplæring # 11: Postmann Intervju Spørsmål

Oversikt over opplæringsprogrammer i postbudserien

Hva du vil lære:

• POSTMAN Introduksjon
• POSTMAN Installasjon
  • Postman Native App
  • Alternativ Quick Postman Installasjonsveiledning
  • Byggesteiner av POSTMAN
    • # 1) Forespørsel
    • # 2) Samling
    • # 3) Miljø
  • Lagre en forespørsel om samling
• Eksempel på forespørsel og svar
• Oppdatering: Tilleggsinformasjon
  • Hva er et API?
  • POSTMAN-klient
    • Hvordan laste ned POSTMAN Client?
  • Ring REST APIer ved hjelp av POSTMAN Client
    • # 1) FÅ Ring
    • # 2) POST-samtale
    • # 3) PUT Ring
    • # 4) Slett samtalen
  • Utfordringer i API-testing
• Konklusjon
  • Anbefalt lesing

POSTMAN Introduksjon

POSTMAN er en API-klient som brukes til å utvikle, teste, dele og dokumentere APIer. Den brukes til backend-testing der vi skriver inn sluttpunkt-URL, den sender forespørselen til serveren og mottar svaret tilbake fra serveren. Det samme kan oppnås gjennom API-maler som Swagger også. I både Swagger og POSTMAN trenger vi ikke å bygge et rammeverk (i motsetning til Parasoft) for å hente svaret fra tjenesten.

Dette er hovedårsaken til at POSTMAN brukes ofte av utviklere og automatiseringsingeniører for å sikre at tjenesten er i gang sammen med build-versjonen av et API som blir distribuert i regionen.

Det hjelper i hovedsak å treffe API-endepunkter ved raskt å lage forespørsler i henhold til API-spesifikasjonen og dissekere de forskjellige svarparametrene som statuskode, overskrifter og selve responsorganet.

Her er en videoopplæring:

Postman tilbyr mange avanserte funksjoner som:

• API-utvikling.
• Sette opp Mock-endepunkter for API-er som fortsatt er under utvikling.
• API-dokumentasjon.
• Påstander om svarene mottatt fra API-endepunktutførelse.
• Integrasjon med CI-CD-verktøy som Jenkins, TeamCity, etc.
• Automatisering av API-tester utførelse etc.

Nå har vi gått gjennom den formelle innføringen av verktøyet, la oss gå videre til installasjonsdelen.

POSTMAN Installasjon

Postman er tilgjengelig i to alternativer.

1. Som en Chrome-app (dette er allerede utfaset og har ingen støtte fra Postman-utviklerne)
2. Native App for forskjellige plattformer som Windows, Mac OS, Linux, etc.

Siden Chrome-apper blir utfaset og har en tett kobling med Chrome-nettleseren (i noen få tilfeller den faktiske nettleserversjonen), vil vi fokusere for det meste ved hjelp av Native-applikasjonen som gir oss mer kontroll og har mindre eksterne avhengigheter.

Postman Native App

Postman Native-appen er en frittstående app som er tilgjengelig for nedlasting i forskjellige OS-plattformer som Windows, Mac OS, Linux, etc. Dette kan lastes ned akkurat som alle andre applikasjoner, avhengig av brukerens plattform.

Installasjonsprosessen er også ganske grei. Du trenger bare å dobbeltklikke på det nedlastede installasjonsprogrammet (for Windows og Mac) og følge instruksjonene.

Når installasjonen er vellykket, er det bare å åpne Postman Application for å komme i gang med.

Vi vil se hvordan du lager en enkel forespørsel for tilgjengelig API med åpen kildekode og ser de forskjellige komponentene i forespørselen og svaret som mottas når forespørselen kjøres ved hjelp av Postman-applikasjonen.

Det anbefales på det sterkeste å logge på / på deg Postman-applikasjonen ved hjelp av en eksisterende e-postkonto. En pålogget konto bevarer alle Postman-samlingene og forespørslene som er lagret under økten, og sørger for at forespørslene fremdeles er tilgjengelige å jobbe med når den samme brukeren logger på neste gang.

Vennligst referer til Merk seksjon for å få detaljer om det offentlig tilgjengelige falske API-endepunktet.

Vi vil illustrere et eksempel på en GET-forespørsel til dette URL som ville returnere 100 innlegg som svar som en JSON-nyttelast.

La oss komme i gang og se på trinnene som må følges:

#1) Åpne Postman-søknaden (Hvis du ikke allerede er logget på med den eksisterende eller nye kontoen, må du først logge på med riktig legitimasjon).

Nedenfor er bildet av Postman UI-startskjermen:

#to) Opprett en ny forespørsel og fyll ut detaljene i henhold til sluttpunktet vi skal bruke til testen eller illustrasjonen vår. La oss teste en få forespørsel om et REST API-sluttpunkt http://dummy.restapiexample.com/api/v1/employees

# 3) Når forespørselegenskapene er fylt ut, trykk SEND for å utføre forespørselen til serveren som er vert for sluttpunktet.

# 4) Når serveren reagerer, kan vi sjekke de forskjellige dataene rundt svaret.

La oss se hver av dem i detalj.

Når svaret er fullført, blir som standard valgt kategorien svar og vist. Andre parametere for et svar som responsstatuskoden, tiden det tar for forespørselen å fullføres, størrelsen på nyttelasten vises like under forespørselsoverskriftene (som i figuren nedenfor).

For å få detaljerte detaljer om responsparametrene som responsstørrelse og responstid, kan du bare sveve over hver av disse verdiene, og Postman vil vise deg en detaljert visning med mer detaljerte detaljer for hver av disse egenskapene.

For eksempel, for forespørselstid - den vil dissekere den videre i individuelle komponenter som Connect time, Socket time, DNS lookup, Handshake, etc.

På samme måte, for svarstørrelse, vil det vise deg en oppdeling av hvor stor størrelse topptekstene er, og hva som er den faktiske responsstørrelsen.

La oss nå se på de andre svarfanene, dvs. informasjonskapsler og overskrifter. I nettverdenen har informasjonskapsler stor betydning når det gjelder å drive opplevelser på klientsiden og mye sesjonsrelatert informasjon for å få all informasjonen om informasjonskapslene som ble returnert fra serveren. Du kan bytte til informasjonskapselfanen og se dette.

Tilsvarende inneholder svarhoder mye nyttig informasjon om forespørselen som ble behandlet. Bare naviger til topptekstfanen i svardelen for å se på svaroverskriftene.

Et viktig poeng å merke seg her er at alle forespørsler du sender til serveren er lagret i Postmann-historikken for fremtidig referanse (Historikk-fanen er tilgjengelig på venstre side av appen).

Dette hjelper til med å forhindre oppretting av forespørsler hver gang du trenger å få svar for den samme forespørselen, og hjelper også til å unngå verdslige oppvarmingsoppgaver. Hvis det er nødvendig, kan du henvise til tidligere forespørsler (Og svar også) på et fremtidig tidspunkt.

Merk: For å illustrere eksempler på forespørsler og svar bruker vi offentlig tilgjengelige falske API-servere som gjør det mulig å lage alle typer HTTP-forespørsler og som returnerer et gyldig HTTP-svar.

For å nevne noen, bruker vi falske API-endepunktsider nedenfor som referanse:

1. Rest-API-eksempel
2. JSON plassholder typicode

Alternativ Quick Postman Installasjonsveiledning

POSTMAN er et åpent verktøy og er tilgjengelig for alle som surfer på internett. Du kan følge trinnene nedenfor og få POSTMAN-verktøyet installert i din lokale maskin.

Trinn 1: Åpen Google og søk etter POSTMAN-verktøyet. Du får søkeresultatet nedenfor. Deretter kan du klikke på Last ned Postman App og du vil bli omdirigert til getpostman-nettstedet.

Ellers kan du navigere direkte til dette URL for å få POSTMAN-verktøyet.

Steg 2: Velg POSTMAN-versjonen basert på operativsystemet ditt. I vårt tilfelle skal vi bruke POSTMAN for Windows OS. Videre bruker vi Window-64 bit, så vi laster ned og installerer POSTMAN for 64 bit.

Trinn 3: Når du har klikket på Last ned-knappen, blir en postman.exe-fil lastet ned til din lokale. Klikk på den filen. Det er en installasjon med ett klikk, akkurat som alle andre applikasjoner som lar deg installere POSTMAN-tillegget for nettleseren din.

Trinn 4: Etter at du har installert applikasjonen, klikker du på applikasjonen (som må plasseres på skrivebordet). Som du kan se i bildet nedenfor, har vi seks forskjellige enheter som du i utgangspunktet trenger tre byggesteiner, dvs. forespørsel, samling og miljø som vil bli diskutert i neste avsnitt.

Det er det!! Vi har installert og lansert POSTMAN-applikasjonen.

Byggesteiner av POSTMAN

POSTMAN har en rekke byggesteiner, men for vårt formål skal vi diskutere de tre store byggesteinene som er essensielle for hver POSTMAN-operasjon.

Disse tre store byggesteinene er:

# 1) Forespørsel

En forespørsel er bare en kombinasjon av den komplette URL-en (som inkluderer alle parametere eller nøkler), HTTP-overskrifter, hovedtekst eller nyttelast. Disse attributtene utgjør en forespørsel. POSTMAN lar deg lagre forespørselen din, og dette er en god funksjon i appen som lar oss bruke den samme forespørselen så mange ganger vi vil.

Klikk på Ny -> Forespørsel

# 2) Samling

Det må være noe du vil lagre bulkforespørslene dine. Dette er scenariet der samlingen kommer inn i bildet. Vi kan si at en samling er et lager der vi kan lagre alle våre forespørsler. Vanligvis holdes forespørslene som treffer samme API i samme samling.

Klikk på Ny -> Samling.

# 3) Miljø

Et miljø er en region der alle operasjonene dine på et API vil finne sted. Det kan være TUP, QA, Dev, UAT eller PROD. Hvert prosjekt vil allerede ha regionene konfigurert, og du må bare erklære dine globale variabler som URL, tokens ID og passord, kontekstnøkler, API-nøkler, dokumentnøkler og så videre i det.

Klikk på Ny -> Miljø.

Lagre en forespørsel om samling

Nå vil vi prøve å lagre en prøveforespørsel i en samling, og vi vil bruke den samme forespørselen til å treffe et API.

Trinn 1: Øverst til høyre ser du “+ Ny” -knappen. Klikk på denne knappen for å få listen over byggesteinene som ble vist da du startet applikasjonen for første gang.

Steg 2: Klikk på Forespørsel.

Trinn 3: Oppgi forespørselsnavnet som er et obligatorisk felt. Klikk deretter på “+ Opprett samling”.

Trinn 4: Når du har klikket på “+ Opprett samling”, vil den be om et navn (si eksempel på samling). Skriv inn navnet på samlingen og trykk enter.

Trinn 5: Klikk på “Lagre i prøvesamling” knapp.

Eksempel på forespørsel og svar

Denne spesielle delen vil gi deg et dypt innblikk i hvordan du tester et API i POSTMAN.

Som du kan se i bildet nedenfor, har vi vår forespørsel som vi allerede har opprettet (Test for SoftwareTestingHelp). Videre kan du se en rullegardinmeny (like ved nettadressen) som har verbene eller metodene som støttes av POSTMAN.

Disse kalles HTTP-verb. Vi vil prøve å oppdatere noe ved hjelp av PUT-metoden, og deretter henter vi det samme ved hjelp av GET-metoden. Jeg antar at leserne er klar over funksjonaliteten til disse HTTP-verbene som brukes i API-testing.

Nå har vi en URL og en forespørselsmetode. Alt vi trenger er topptekster og nyttelast eller kropp. I noen tilfeller må vi generere tokens (basert på behovene til en API).

Vi vil erklære våre HTTP-overskrifter, dvs. innholdstype og godta. Aksept er ikke alltid obligatorisk, da det bestemmer formatet vi skal hente svaret på. Som standard er svaret alltid JSON.

Det er ikke nødvendig å kruse verdiene til disse overskriftene, da POSTMAN gir deg forslagene når du skriver inn tekstområdene til nøkkelen og verdien.

Deretter vil vi gå videre til neste obligatoriske del som er kropp. Her vil vi gi nyttelasten i form av JSON. Vi er klar over hvordan vi skal skrive vår egen JSON, derfor vil vi prøve å lage vår egen JSON.

Eksempel på forespørsel

URL: http://www.mocky.io/v2/5cd6c3f23000004b006061c5

Overskrifter

safe registry cleaner for Windows 7

Innholdstype: applikasjon / JSON
Godta = applikasjon / JSON

Kropp

Nå treffer det

Når du har en fullstendig forespørsel, klikker du på “Send-knappen” og ser svarkoden. En 200 OK-kode står for vellykket drift. På bildet nedenfor kan du se at vi har truffet nettadressen.

Det neste steget

Nå skal vi utføre en annen operasjon kalt GET. Vi vil prøve å hente den samme posten som vi nettopp har opprettet.

Vi krever ikke kropp eller nyttelast for GET-operasjonen. Ettersom vi allerede har prøveforespørselen vår ved hjelp av PUT-metoden, er alt vi trenger å endre metoden til GET.

Når vi har endret oss til GET, treffer vi tjenesten igjen. Som du kan se i bildet nedenfor, har vi nøyaktig hva vi passerte, og dette er hvordan POSTMAN fungerer.

Oppdatering: Tilleggsinformasjon

Hva er et API?

API (Application Programming Interface) er en jar-fil som inneholder flere metoder og grensesnitt for å utføre en bestemt handling.

Se eksemplet nedenfor og skjermbilde nedenfor:

1. Lag en summetode som legger til to variabler og returnerer summen av to variabler.
2. Opprett deretter en kalkulatorklasse som inneholder flere andre metoder som tillegg, subtraksjon, multiplikasjon, divisjon og så videre. Det kan også være noen hjelperklasser. Nå kombinerer du alle klassene og grensesnittene, og opprett en jar-fil kalt Calculator.jar, og publiser den deretter. Bruk Calculator API for å få tilgang til metodene som er tilstede inne.
3. Noen API-er er åpen kildekode (Selenium) som kan redigeres, og andre er lisensierte (UFT) som ikke kan redigeres.

Foreslått lese => Topp API Management Tools

Hvordan blir disse metodene kalt?

Utviklere vil avsløre et grensesnitt, en plattform for å ringe kalkulatorens API, og vi oppretter objektet til kalkulatorklassen og kaller summetoden eller hvilken som helst metode.

Anta at denne calculator.jar-filen er opprettet av noe selskap, og de bruker dette verktøyet via UI-grensesnitt, så tester vi dette kalkulatorprogrammet ved hjelp av UI og automatiserer det ved hjelp av QTP / Selen, og dette kalles Front End Testing.

Noen applikasjoner har ikke brukergrensesnitt, og for å få tilgang til disse metodene lager vi et objekt av klassen og gir argumentene videre for å teste, og dette kalles Back-End-testing . Å sende forespørselen og motta svaret vil skje gjennom JSON / XML-filer.

Se diagrammet nedenfor:

POSTMAN-klient

• POSTMAN er en REST-klient som brukes til å utføre API-testing av backend.
• I POSTMAN passerer vi API-samtalen og sjekker API-responsen, statuskodene og nyttelasten.
• Swagger er et annet HTTP-klientverktøy der vi oppretter API-dokumentasjon, og gjennom swagger kan vi også treffe API-en og få svaret.
• Se lenken https://swagger.io/
• Du kan bruke enten Swagger eller POSTMAN for å teste API-ene, og det avhenger av selskaper som hvilken klient du skal bruke.
• I POSTMAN bruker vi hovedsakelig GET, POST, PUT og DELETE samtaler.

Hvordan laste ned POSTMAN Client?

Åpne Google Chrome og last ned POSTMAN-appen som er tilgjengelig i Chrome app store.

Ring REST APIer ved hjelp av POSTMAN Client

I POSTMAN har vi mange metoder, men vi bruker bare GET, PUT, POST og SLETT

• POST - Denne samtalen skaper en ny enhet.
• FÅ - Denne samtalen sender forespørselen og mottar svaret.
• SETTE - Denne samtalen oppretter en ny enhet og oppdaterer den eksisterende enheten.
• SLETT - Denne samtalen sletter den eksisterende enheten.

API-er kan nås enten ved å bruke UI som bankplattform eller der UI ikke er tilgjengelig, som backend-systemene der vi bruker REST API-klient som POSTMAN.

Andre klienter er også tilgjengelige som SOAP UI som er en REST- og SOAP-klient, avanserte REST-klienter som JMeter kan ringe API-ene direkte fra nettleseren. POSTMAN er det beste verktøyet for å utføre POST- og GET-operasjoner.

Les også => Liste over dybdegående opplæringsprogrammer for SoapUI

Send en forespørsel og få svar i POSTMAN Client:

For testformål bruker vi de medfølgende API-ene her .

Sjekk hvert CRUD-anrop i POSTMAN-klienten ved hjelp av API-ene fra dummy-nettstedet.

I API-testing validerer vi hovedsakelig punktene nedenfor:

• Svarstatuskodene, se wiki-side for detaljer.
• Svarmeldingen og JSON-responsorganet.
• Ved API-testing må du først be utvikleren om å oppgi endepunkt-URL. Se denne sluttpunkt-URLen https://reqres.in/.

# 1) FÅ Ring

Sender forespørselen og mottar svaret.

Fremgangsmåte for testing av REST API:

• Sende https://reqres.in//api/users?page=2 (? er en spørringsparameter som filtrerer ut resultatet som å skrive ut all informasjonen til brukeren på side 2, spørringsparameteren avhenger av utvikleren som hvordan de vil definere) som URI i POSTMAN-klienten.
• Spørringsparameteren er definert av (?) Og styparameteren er definert av (/).
• Velg GET-metoden.

• Gi overskrifter (hvis nødvendig) som User-Agent: “Programvare”.

• Klikk på SEND-knappen.
• Hvis API fungerer bra, som svar får vi:
  • Status 200 - OK, dette betyr at svaret blir mottatt.
  • Svar JSON nyttelast.
  • Strengmelding

• En annen Eksempel av GET METODEN, der vi søkte etter informasjon om en bestemt bruker, dvs. bruker-id = 3. Skriv inn URI = https://reqres.in/api/users/3

• Hvis data ikke er tilgjengelig mot søket vårt, får vi blank JSON- og 404-statusmelding.

# 2) POST-samtale

Opprett en ny bruker eller en enhet.

Fremgangsmåte for å utføre:

• Velg en POST fra rullegardinmenyen og bruk denne tjenestens URL “https://reqres.in/api/users/100”
  
• Gå til Body -> velg RAW -> Mens vi passerer JSON.
• Velg JSON fra rullegardinmenyen og lim inn nyttelastskriptet.
• Pass denne nyttelasten {“navn”: ”Morfeus”, ”jobb”: ”leder”}

• JSON starter med krøllete bukseseler og lagrer data i nøkkelverdien.
• Send overskriftens innholdstype = applikasjon / json.
• Trykk på SEND-knappen.

• På vellykket forespørsel får vi svaret nedenfor:
  • Status 201 - Opprettet, mottas svaret.
  • Svar nyttelast
  • Overskrift

# 3) PUT Ring

Oppdaterer eller oppretter en ny enhet.

Fremgangsmåte for å opprette PUT-samtale:

• Bruk denne tjenestens URL “https://reqres.in/api/users/206” og nyttelast {“name”: “Morpheus”, ”job”: “Manager”
• Gå til POSTMAN-klienten og velg PUT-metode -> Gå til Body -> Velg RAW> pass JSON og velg JSON fra rullegardinmenyen og lim inn nyttelastskriptet.
• JSON starter med krøllete bukseseler og lagrer data i nøkkelverdien.
• Trykk på SEND-knappen for å få en vellykket forespørsel, vil du få svaret nedenfor.
  • Status 200 - Ok, svaret er mottatt.
  • Svar nyttelast
  • Overskrift
  • Jobben er oppdatert til “manager”

# 4) Slett samtalen

• Slett brukeren, bruk denne tjenestens URL “/ api / users / 423” og denne nyttelasten {“name”: “Naveen”, ”job”: “QA”}.
• Gå til POSTMAN og velg SLETT-metoden, nyttelast er ikke nødvendig.
• Sletter bruker-ID = 423 hvis tilgjengelig i systemet.
  • Status 204 - Ingen innhold, svaret mottatt vellykket.
  • Ingen nyttelast mottatt, bruker-ID slettet.
  • Overskrift

Utfordringer i API-testing

• Testtilfeller skal utformes slik at de skal dekke testdekning.
• Å designe testtilfeller er enkelt når API har færre parametere, men kompleksiteten øker når antall parametere er stort.
• Oppdater testdekningen regelmessig med en endring i forretningskravet. Hvis en ny parameter legges til, øker du testselet
• Sekvensering av API-anrop ordentlig.
• Utforsk grenseforhold og ytelse.

Konklusjon

I denne opplæringen diskuterte vi de viktige tipsene for å komme i gang med Postman API-testverktøyet. Vi lærte å installere Postman-verktøyet som et frittstående program og diskuterte hvordan vi kan gå frem for å lage en enkel forespørsel og se på generert respons.

Vi så hvordan vi navigerer til de forskjellige delene av responsinformasjonen, samt hvordan du gjennomgår og henter forespørslene fra historikkfanen.

Vi tror at du nå kan utføre en vellykket operasjon på et API. Vellykket operasjon på et API betyr ikke kopiering og liming av hele kroppen, overskrifter og andre nødvendige blokker og å gjøre testutførelsen vellykket.

Det handler om hvor komfortabel du er med å skrive din egen JSON, navigere til et bestemt felt i en JSON ved hjelp av dokumentnøkkelen eller parameterne, forstå matriser i JSON, etc.

POSTMAN klientverktøy brukes til å utføre back-end testing og hovedsakelig for å utføre GET, PUT, POST, SLETT samtaler.

Fra denne veiledningen lærte vi hvordan vi kunne ringe samtalene fra POSTMAN-klienten og hvordan vi validerte svaret vi får tilbake fra serveren, og dekket også utfordringene i API-testing.

API-testing er veldig viktig for å finne smutthull i API-er, da hackere vil utnytte dem og forårsake økonomiske tap. API-testing virker enkel, men vi bør være veldig forsiktige og prøve å teste med alle mulige kombinasjoner.

I vår kommende opplæring vil vi lære hvordan du bruker Postman-verktøyet for Diff API Formats!

PREV Opplæring | NESTE veiledning

Anbefalt lesing

• Parasoft SOAtest Tutorial: Scriptless API Testing Tool
• API Testing Tutorial: En komplett guide for nybegynnere
• Beste verktøy for testing av programvare 2021 (QA Test Automation Tools)
• Destruktiv testing og ikke-destruktiv testing
• Funksjonstesting mot ikke-funksjonell testing
• Veiledning for WAVE tilgjengelighetstestverktøy
• Veiledning for tilgjengelighetsprøving (en komplett trinnvis veiledning)
• SOA Testing Tutorial: Testing Methodology For a SOA Architecture Model