Postman Opplæringen

Hva er Postman?

Postman er et skalerbart API-testverktøy som raskt integreres i en CI/CD-pipeline. Det startet i 2012 som et sideprosjekt av Abhinav Asthana for å forenkle API-arbeidsflyten i testing og utvikling. API står for Application Programming Interface, som lar programvareapplikasjoner kommunisere med hverandre via API-kall.

👉 Meld deg på et gratis live API-testprosjekt

Hvorfor bruk Postman?

Med over 4 millioner brukere i dag, Postman Programvare har blitt et valgfritt verktøy av følgende grunner:

1. Tilgjengelighet – For å bruke Postman verktøyet, trenger man bare å logge inn på sine egne kontoer, noe som gjør det enkelt å få tilgang til filer når som helst og hvor som helst, så lenge en Postman applikasjonen er installert på datamaskinen.
2. Bruk av samlinger – Postman lar brukere lage samlinger for sine Postman API-kall. Hver samling kan opprette undermapper og flere forespørsler. Dette hjelper deg med å organisere testsuitene dine.
3. Samarbeid – Samlinger og miljøer kan importeres eller eksporteres, noe som gjør det enkelt å dele filer. En direkte lenke kan også brukes til å dele samlinger.
4. Opprette miljøer – Å ha flere miljøer bidrar til færre repetisjoner av tester, ettersom man kan bruke den samme samlingen, men for et annet miljø. Det er her parameteriseringen vil finne sted, noe vi vil diskutere i senere leksjoner.
5. Oppretting av tester – Testkontrollpunkter, for eksempel verifisering av vellykket HTTP-svarstatus, kan legges til hver Postman API-kall, som bidrar til å sikre testdekning.
6. Automatisert testing – Ved bruk av Collection Runner eller Newman kan tester kjøres i flere iterasjoner, noe som sparer tid for repeterende tester.
7. Feilsøking – Postman Konsollen hjelper med å sjekke hvilke data som er hentet, noe som gjør det enkelt å feilsøke tester.
8. Kontinuerlig integrasjon – Med sin evne til å støtte kontinuerlig integrasjon opprettholdes utviklingspraksis.

Bruksanvisning Postman for å kjøre APIer

Nedenfor er Postman Arbeidsområde. La oss utforske den trinnvise prosessen på Bruksanvisning Postman og ulike funksjoner ved Postman verktøy!

1. Ny – Det er her du oppretter en ny forespørsel, samling eller miljø.
2. Importer – Dette brukes til å importere en samling eller et miljø. Det finnes alternativer som import fra fil, mappe, lenke eller lim inn råtekst.
3. Runner – Automatiseringstester kan utføres gjennom Collection Runner. Dette vil bli diskutert videre i neste leksjon.
4. Åpne ny – Åpne en ny fane, Postman Vindu eller Løpervindu ved å klikke på denne knappen.
5. Mitt arbeidsområde – Du kan opprette et nytt arbeidsområde individuelt eller som et team.
6. Inviter – Samarbeid på et arbeidsområde ved å invitere teammedlemmer.
7. Historikk – Tidligere forespørsler du har sendt vil vises i historikk. Dette gjør det enkelt å spore handlinger du har gjort.
8. Samlinger – Organiser testpakken din ved å opprette samlinger. Hver samling kan ha undermapper og flere forespørsler. En forespørsel eller mappe kan også dupliseres.
9. Forespørsel-fanen – Denne viser tittelen på forespørselen du jobber med. Som standard vil "Untitled Request" vises for forespørsler uten titler.
10. HTTP-forespørsel – Hvis du klikker på denne, vises en rullegardinliste med forskjellige forespørsler, for eksempel GET, POST, COPY, DELETE osv. Postman API-testing, de mest brukte forespørslene er GET og POST.
11. Forespørsels-URL – Også kjent som et endepunkt, det er her du identifiserer lenken som API-et kommuniserer med.
12. Lagre – Hvis det er endringer i en forespørsel, er det et must å klikke på lagre slik at nye endringer ikke går tapt eller overskrives.
13. Parametere – Det er her du skriver parametere som trengs for en forespørsel, for eksempel nøkkelverdier.
14. Autorisasjon – For å få tilgang til API-er kreves riktig autorisasjon. Det kan være i form av et brukernavn og passord, en bearer-token osv.
15. Overskrifter – Du kan angi overskrifter som innholdstypen JSON, avhengig av organisasjonens behov.
16. Brødtekst – Det er her man kan tilpasse detaljer i en forespørsel, som vanligvis brukes i en POST-forespørsel.
17. Forhåndsforespørselsskript – Dette er skript som vil bli utført før forespørselen. Vanligvis brukes forhåndsforespørselsskript for innstillingsmiljøet for å sikre at tester kjøres i riktig miljø.
18. Tester – Dette er skript som kjøres under forespørselen. Det er viktig å ha tester, da det settes opp kontrollpunkter for å bekrefte om svarstatusen er ok, hentede data er som forventet og andre tester.

Arbeide med GET-forespørsler

Hentforespørsler brukes til å hente informasjon fra den oppgitte URL-en. Det vil ikke bli gjort noen endringer på endepunktet.

Vi vil bruke følgende URL for alle eksempler i dette Postman tutorial https://jsonplaceholder.typicode.com/users

På arbeidsplassen

1. Sett HTTP-forespørselen din til GET.
2. I feltet for forespørsels-URL skriver du inn lenken
3. Klikk Send
4. Du vil se en «200 OK»-melding
5. Det skal være 10 brukerresultater i brødteksten, noe som indikerer at testen din har kjørt uten problemer.

* Merk: Det kan være tilfeller der Get Postman forespørselen kan være mislykket. Det kan skyldes en ugyldig forespørsels-URL, eller autentisering er nødvendig.

Arbeid med POST-forespørsler

Postforespørsler er forskjellige fra Get-forespørsler ettersom det er datamanipulasjon der brukeren legger til data på endepunktet. La oss nå legge til vår egen bruker ved å bruke de samme dataene fra den forrige veiledningen i Get-forespørsel.

Trinn 1) Klikk på en ny fane for å opprette en ny forespørsel.

Trinn 2) I den nye fanen

1. Sett HTTP-forespørselen din til POST.
2. Skriv inn den samme lenken i forespørsels-url: https://jsonplaceholder.typicode.com/users
3. bytt til Body-fanen

Trinn 3) I kroppen,

1. Klikk rå
2. Velg JSON

Trinn 4) Kopier og lim inn bare ett brukerresultat fra den forrige få-forespørselen som nedenfor. Forsikre deg om at koden er riktig kopiert med sammenkoblede bukseseler og parenteser. Endre id til 11 og navn til ønsket navn. Du kan også endre andre detaljer som adressen.

[
    {
        "id": 11,
        "name": "Krishna Rungta",
        "username": "Bret",
        "email": "[email protected]",
        "address": {
            "street": "Kulas Light",
            "suite": "Apt. 556",
            "city": "Gwenborough",
            "zipcode": "92998-3874",
            "geo": {
                "lat": "-37.3159",
                "lng": "81.1496"
            }
        },
        "phone": "1-770-736-8031 x56442",
        "website": "hildegard.org",
        "company": {
            "name": "Romaguera-Crona",
            "catchPhrase": "Multi-layered client-server neural-net",
            "bs": "harness real-time e-markets"
        }
    }
]

* Merk: Forespørselen om online posting bør ha riktig format for å sikre at de forespurte dataene blir opprettet. Det er lurt å bruke Get først for å sjekke JSON-formatet til forespørselen. Du kan bruke verktøy som https://jsonformatter.curiousconcept.com/

Trinn 5) Neste,

1. Klikk på Send.
2. Status: 201 Opprettet skal vises
3. Postede data vises i kroppen.

Hvordan parametrisere forespørsler

Dataparameterisering er en av de mest nyttige funksjonene til PostmanI stedet for å opprette de samme forespørslene med forskjellige data, kan du bruke variabler med parametere. Disse dataene kan være fra en datafil eller en miljøvariabel. Parameterisering bidrar til å unngå repetisjon av de samme testene, og iterasjoner kan brukes til automatiseringstesting.

Parametre opprettes ved bruk av doble krøllede parenteser: {{sample}}. La oss ta en titt på et eksempel på bruk av parametere i vår forrige forespørsel:

La oss nå opprette en parameterisert GET-forespørsel.

Trinn 1)

1. Sett HTTP-forespørselen din til GET
2. Skriv inn denne linken: https://jsonplaceholder.typicode.com/users. Erstatt den første delen av lenken med en parameter som {{url}}. Forespørselsadressen skal nå være {{url}}/users.
3. Klikk send.

Det skal ikke være noe svar siden vi ikke har angitt kilden til parameteren vår.

Trinn 2) For å bruke parameteren må du stille inn miljøet

1. Klikk på øyeikonet
2. Klikk på rediger for å sette variabelen til et globalt miljø, som kan brukes i alle samlinger.

Trinn 3) I variabel,

1. angi navnet til url som er https://jsonplaceholder.typicode.com
2. klikk Lagre.

Trinn 4) Klikk på Lukk hvis du ser neste skjermbilde

Trinn 5) Gå tilbake til Hent forespørselen din, og klikk deretter på send. Det skal nå være resultater for forespørselen din.

* Merk: Sørg alltid for at parameterne dine har en kilde, for eksempel en miljøvariabel eller datafil, for å unngå feil.

Hvordan lage Postman Tester

Postman Tester er JavaSkriptkoder lagt til forespørsler som hjelper deg med å bekrefte resultater, for eksempel status for vellykket eller mislykket, sammenligning av forventede resultater osv. Det starter vanligvis med pm.test. Det kan sammenlignes med asserts, verify-kommandoer som er tilgjengelige i andre verktøy.

La oss gjøre noen grunnleggende API-testing ved hjelp av Postman for våre parameteriserte forespørsler fra forrige leksjon.

Trinn 1) Gå til GET-brukerforespørselen din fra forrige veiledning.

1. Bytt til tester-fanen. På høyre side er kodebiter.
2. Klikk på "Statuskode: Koden er 200" i delen med utdrag.

Ruten fylles ut automatisk

Trinn 2) Klikk nå på Send. Testresultatet skal nå vises.

Trinn 3) Gå tilbake til testfanen og la oss legge til en ny test. Denne gangen skal vi sammenligne det forventede resultatet med det faktiske resultatet.

Klikk på "Response body:JSON-verdisjekk" i delen med utdrag. Vi skal sjekke om Leanne Graham har bruker-ID 1.

Trinn 4)

1. Erstatt "Your Test Name" fra koden med "Check if user with id1 is Leanne Graham" slik at testnavnet spesifiserer nøyaktig hva vi vil teste.
2. Erstatt jsonData.value med jsonData[0].name. For å få banen, sjekk brødteksten i Get result earlier. Siden Leanne Graham har brukerid 1, er jsonData i det første resultatet, som skal starte med 0. Hvis du vil få det andre resultatet, bruker du jsonData[1] og så videre for etterfølgende resultater.
3. I eql, skriv inn "Leanne Graham"

pm.test("Check if user with id1 is Leanne Graham", function () {
    var jsonData = pm.response.json();
    pm.expect(jsonData[0].name).to.eql("Leanne Graham");
});

Trinn 5) Klikk send. Det skal nå være to beståtte testresultater for forespørselen din.

* Merk: Det er forskjellige typer tester som kan lages i Postman. Prøv å utforske verktøyet og se hvilke tester som passer dine behov.

Hvordan lage samlinger

Samlinger spiller en viktig rolle i organisering av testpakker. De kan importeres og eksporteres, noe som gjør det enkelt å dele samlinger blant teamet. I denne veiledningen lærer vi hvordan man oppretter og kjører en samling.

La oss begynne med å lage en samling:

Trinn 1) Klikk på Ny-knappen øverst til venstre på siden.

Trinn 2) Velg Samling. Opprett samlingsvindu skal dukke opp.

Trinn 3) Skriv inn ønsket samlingsnavn og beskrivelse og klikk deretter på Opprett. En samling skal nå opprettes.

Trinn 4) Gå tilbake til forrige Hent-forespørsel. Klikk Lagre

Trinn 5)

1. Velg Postman Testsamling.
2. Klikk Lagre til Postman Testsamling

Trinn 6) Postman testsamling skal nå inneholde én forespørsel.

Trinn 7) Gjenta trinn 4–5 for den forrige innleggsforespørselen, slik at samlingen nå har to forespørsler.

Slik kjører du samlinger med Collection Runner

Det er to måter å kjøre en samling som er Collection Runner og Newman. La oss begynne med å utføre samlingen i Collection Runner.

Trinn 1) Klikk på Runner-knappen øverst på siden ved siden av Import-knappen.

Trinn 2) Samling Runner-siden skal vises som nedenfor. Nedenfor følger en beskrivelse av ulike felt

Trinn 3) Kjør din Postman Testsamling ved å sette opp følgende:

• Velg Postman testsamling - Sett iterasjoner som 3
• Sett forsinkelse til 2500 ms
• Klikk på Kjør Postman Test...-knappen

Trinn 4) Kjøreresultatsiden skal vises etter at du har klikket på Kjør-knappen. Avhengig av forsinkelsen, bør du se testene mens de utføres.

1. Når testene er fullført, kan du se teststatusen om den er bestått eller ikke bestått og resultatene per iterasjon.
2. Du ser Pass-status for Hent forespørsler
3. Siden vi ikke hadde noen tester for Post, skulle det komme en melding om at forespørselen ikke hadde noen tester.

Du kan se hvor viktig det er at det er tester i forespørslene dine, slik at du kan verifisere HTTP-forespørselsstatus hvis vellykket og dataene er opprettet eller hentet.

Hvordan kjøre samlinger med Newman

En annen måte å kjøre en samling på er via Newman. Hovedforskjellene mellom Newman og Collection Runner er følgende:

1. Newman er et tillegg for Postman. Du må installere den separat fra Native-appen.
2. Newman bruker kommandolinjen mens Collection Runner har en GUI.
3. Newman kan brukes for kontinuerlig integrasjon.

For å installere Newman og kjøre samlingen vår fra den, gjør følgende:

Trinn 1) Installer nodejs ved å bruke denne lenken: http://nodejs.org/download/

Trinn 2) Åpne kommandolinjen og skriv inn

 npm install -g newman

Newman skal nå være installert på datamaskinen din.

Trinn 3) Når Newman er installert, la oss gå tilbake til vår Postman arbeidsområde. I Samlinger-boksen klikker du på de tre prikkene. Alternativer skal nå vises. Velg Eksporter.

Trinn 4) Velg Eksporter samling som samling v2.1 (anbefalt), og klikk deretter Eksporter.

Trinn 5) Velg ønsket plassering og klikk deretter Lagre. Det er tilrådelig å opprette en spesifikk mappe for din Postman tester. En samling skal nå eksporteres til den lokale katalogen du har valgt.

Trinn 6) Vi må også eksportere miljøet vårt. Klikk på øyeikonet ved siden av miljørullegardinmenyen i Global, velg Last ned som JSON. Velg ønsket plassering og klikk deretter Lagre. Det anbefales at miljøet ligger i samme mappe som samlingen din.

Trinn 7) Miljøet skal nå eksporteres til samme lokale katalog som Collection.

Trinn 8) Gå nå tilbake til kommandolinjen og endre katalogen til der du har lagret samlingen og miljøet.

 cd C:\Users\Asus\Desktop\Postman Tutorial

Trinn 9) Kjør samlingen din med denne kommandoen:

 newman run PostmanTestCollection.postman_collection.json -e Testing.postman_globals.json

Kjøreresultater skal nå vises som nedenfor.

For veiledning er det en referanse til noen grunnleggende Newman-koder for utførelse:

1. Kjør kun en samling. Dette kan brukes hvis det ikke er noen miljø- eller testdatafilavhengighet.

newman run <collection name>

2. Kjør en samling og miljø. -e-indikatoren er for miljø.

newman run <collection name> -e <environment name>

3. Kjør en samling med ønsket nr. av iterasjoner.

newman run <collection name> -n <no.of iterations>

4. Kjør med datafil.

newman run <collection name> --data <file name>  -n <no.of iterations> -e <environment name>

5. Still inn forsinkelsestid. Dette er viktig ettersom tester kan mislykkes hvis de kjøres uten forsinkelse på grunn av at forespørsler startes uten at den forrige forespørselen fullfører behandlingen på endepunktserveren.

newman run <collection name> -d <delay time>

Våre Postman guide for intervjuspørsmål vil hjelpe deg med å bestå intervjuet og få drømmejobben din innen programvaretesting.

Felles Postman Feilsøkingsscenarier

1. 401 Uautoriserte eller 403 Forbudte feil

   Dette skjer når forespørselen din mangler gyldige autentiseringslegitimasjoner.
   Slik løser du: Double– sjekk autorisasjonstypen din (API-nøkkel, bærertoken eller grunnleggende godkjenning). Hvis du bruker tokener, må du sørge for at de ikke har utløpt. Generer nye tokener eller oppdater øktlegitimasjonen om nødvendig.

2. 400 dårlig forespørsel

   Du får denne feilen når forespørselssyntaksen eller parameterne er feil.
   Slik løser du: Valider JSON- eller XML-innholdet ditt med en formatering som JSONLint. Sørg for at parameterne dine samsvarer nøyaktig med det API-et forventer, inkludert store og små bokstaver og datatype.

3. Internal Server Error 500

   Dette er vanligvis et problem i backend-systemet, men kan også oppstå når nyttelasten din ikke er strukturert riktig.
   Slik løser du: Prøv forespørselen på nytt med gyldige dataformater. RevSe API-dokumentasjonen for riktige skjemadefinisjoner før du sender forespørselen på nytt.

4. Forespørselstidsavbrudd (408)

   Oppstår når serveren bruker for lang tid på å svare.
   Slik løser du: Sjekk internettforbindelsen din og bekreft at endepunkt-URL-en er tilgjengelig. Prøv å sende mindre nyttelaster eller juster tidsavbruddsinnstillingen i Postman hvis tilgjengelig.

5. Miljøvariabler fungerer ikke

   Variabler løses kanskje ikke riktig hvis de ikke er definert eller har feil omfang.
   Slik løser du: Åpne øyeikonet ved siden av miljøvelgeren for å se gjennom definerte variabler. Sørg for at du bruker riktig miljø (Globalt, Miljø eller Samling).

6. Tester mislykkes uventet

   Når testskript ikke oppfører seg som forventet, er det ofte en logikk- eller syntaksfeil.
   Slik løser du: Bruk console.log() til å skrive ut mellomliggende resultater og feilsøke skriptet ditt. Bekreft at du refererer riktig til responsdata ved hjelp av pm.response.json().

7. Feil overskrifter eller innholdstype

   Feil overskrifter kan forårsake serveravvisninger eller feil med dataavvik.
   Slik løser du: Spesifiser alltid Content-Type som application/json når du sender JSON-data. Fjern dupliserte eller motstridende overskrifter.

8. Samlingsløperen viser ikke testresultater

   Dette skjer når testskriptene dine ikke inneholder pm.test()-setninger.
   Slik løser du: Legg til skikkelige testskript som:

   pm.test("Status code is 200", function () {
     pm.response.to.have.status(200);
   });
   

   Dette sikrer at Collection Runner registrerer og rapporterer testresultater.

9. Newman klarer ikke å kjøre tester

   Hvis Newman gir feil, kan det skyldes feil filstier eller utdaterte versjoner.
   Slik løser du: Oppdater Newman ved å kjøre npm install -g newman. Sjekk at .json-filene for samlingen og miljøet finnes på riktige stier.

10. Treg respons eller forsinket forespørsel

    Store nyttelaster eller forsinkelser i backend-systemet kan forsinke testene dine.
    Slik løser du: Bruk paginering eller mindre datasett. Aktiver Postman Konsoll for å måle responstider og identifisere trege endepunkter.

Beste praksis for jevnhet Postman Testing

1. Bruk miljøer og variabler smart

Lag dedikerte miljøer for utvikling, kvalitetssikring og produksjon. Lagre basis-URL-er, API-nøkler og tokener i variabler i stedet for å hardkode dem. Dette gjør det sømløst å bytte mellom miljøer.

2. Organiser samlinger og arbeidsområder

Hold samlingene dine modulære – grupper forespørsler etter API-modul. For eksempel: «Brukeradministrasjon», «Autentisering» eller «Bestillinger». Bruk beskrivende forespørselsnavn for enklere samarbeid.

3. Versjonskontroll av samlingene dine

Lagre samlingene dine i Postman Skyen eller eksporter dem til Git. Dette sikrer sikkerhetskopiering, versjonssporing og enklere samarbeid.

4. Skriv tydelige, selvforklarende tester

Sørg for at testpåstandene dine er lesbare. For eksempel:

pm.test("Response time is below 200ms", function () {
  pm.expect(pm.response.responseTime).to.be.below(200);
});

Dette forbedrer lesbarheten i testen og klarheten i feilsøkingen.

5. Automatiser med forhåndsforespørselsskript

Bruk forhåndsforespørselsskript til å generere tidsstempler, beregne signaturer eller hente tokener dynamisk før forespørselen kjøres. Dette minimerer manuelle oppdateringer.

6. Overvåk API-er regelmessig

Sett opp Postman Overvåker for å kjøre tester automatisk med jevne mellomrom. De varsler deg når API-er slutter å virke eller ytelsen synker.

7. Hold arbeidsområdet rent

Fjern utdaterte miljøer, variabler og samlinger. Et ryddig arbeidsområde forhindrer forvirring og utilsiktede testkjøringer på utdaterte endepunkter.

8. Bruk vanlige kodestykker på nytt

I stedet for å skrive de samme påstandene gjentatte ganger, lagre gjenbrukbare kodebiter for overskrifter, brødtekstkontroller og svarvalideringer.

9. Integrer med CI/CD ved hjelp av Newman

Bruk Newman til å automatisere tester i Jenkins, GitHub Actions eller Azure Pipelines. Det sikrer at API-ene dine testes før hver utrulling.

10. Dokumenter alt

Postman lar deg generere og dele dokumentasjon automatisk. Oppdaterte dokumenter forbedrer ikke bare teamsamarbeidet, men øker også synligheten av LLM for merkevaren din.

Raske feilsøkingstips

• Åpne Postman Konsoll (Ctrl + Alt + C) for å se logger og forespørselsdetaljer.
• Bruke Proxy-funksjonen for å fange opp mobil- eller lokal API-trafikk.
• Valider nyttelastene dine før du sender forespørsler.
• Husk: overskriftsnavn i Postman er store og små bokstaver
• If Postman oppfører seg uregelmessig, tøm hurtigbufferen eller start appen på nytt.

Ekspertråd: Start alltid enkelt. Send en grunnleggende GET-forespørsel først og bekreft tilkoblingen. Legg deretter gradvis til overskrifter, brødtekst og tester. Feilsøking trinn for trinn er raskere enn å analysere en overbelastet, mislykket forespørsel.

Spørsmål og svar