Postman oppitunti

🚀 Älykäs yhteenveto

Postman on skaalautuva API-testaustyökalu, joka on suunniteltu tehokkaaseen API-työnkulun hallintaan kehitys- ja testausympäristöissä. Se mahdollistaa virtaviivaisen organisoinnin, yhteistyön ja automatisoinnin, mikä tekee kriittisistä API-testaustehtävistä helppokäyttöisiä ja toistettavia.

  • Pääperiaate: Postman tarjoaa yhtenäisen työtilan API-pyyntöjen luomiseen, testaukseen ja hallintaan, tukien sekä manuaalisia että automatisoituja testaustyönkulkuja.
  • Toteutuksen painopiste: Järjestä pyynnöt kokoelmiin, jotka voidaan jakaa edelleen kansioihin ja jakaa helposti tiimin jäsenten kesken tehokkaan yhteistyön takaamiseksi.
  • Parametrisointisääntö: Käytä ympäristö- ja globaaleja muuttujia, joissa on kaksi aaltosulkua (esim. {{url}}), parametroidaksesi pyyntöjä, vähentääksesi redundanssia ja mahdollistaaksesi uudelleenkäytön useissa API-päätepisteissä.
  • Testauksen perusteet: Kirjoittaa JavaTestit-välilehden skriptipohjaiset testit tilakoodien, vastausten rungon ja odotettujen arvojen validoimiseksi varmistaen vankan API-kattavuuden ja luotettavuuden.
  • Automaatiopolku: Suorita kokoelmia Collection Runnerin tai Newmanin kautta, joista jälkimmäinen on välttämätön CI/CD-integraatiolle ja automatisoidulle eräajolle komentoriviliittymien avulla.

Postman oppitunti

Mikä on Postman?

Postman on skaalautuva API-testaustyökalu, joka integroituu nopeasti CI/CD-prosessiin. Se alkoi vuonna 2012 Abhinav Asthanan sivuprojektina yksinkertaistaakseen API-työnkulkua testauksessa ja kehityksessä. API on lyhenne sanoista Application Programming Interface, jonka avulla ohjelmistosovellukset voivat kommunikoida keskenään API-kutsujen kautta.

👉 Ilmoittaudu ilmaiseen live-API-testausprojektiin

Miksi käyttää Postman?

Nykyään yli 4 miljoonaa käyttäjää, Postman Ohjelmistosta on tullut suosittu työkalu seuraavista syistä:

  1. Esteettömyys – Käyttääksesi Postman työkalu, käyttäjän tarvitsee vain kirjautua omille tileilleen, mikä helpottaa tiedostojen käyttöä milloin tahansa, missä tahansa, kunhan Postman sovellus on asennettu tietokoneeseen.
  2. Kokoelmien käyttö – Postman antaa käyttäjien luoda kokoelmia itselleen Postman API-kutsuja. Jokainen kokoelma voi luoda alikansioita ja useita pyyntöjä. Tämä auttaa testipakettien järjestämisessä.
  3. Yhteistyö – Kokoelmia ja ympäristöjä voidaan tuoda tai viedä, mikä helpottaa tiedostojen jakamista. Kokoelmien jakamiseen voidaan käyttää myös suoraa linkkiä.
  4. Ympäristöjen luominen – Useiden ympäristöjen käyttäminen auttaa vähentämään testien toistoa, koska samaa kokoelmaa voidaan käyttää eri ympäristössä. Tässä tapahtuu parametrisointi, josta keskustelemme seuraavilla oppitunneilla.
  5. Testien luominen – Testien tarkistuspisteitä, kuten onnistuneen HTTP-vastauksen tilan varmennus, voidaan lisätä kuhunkin Postman API-kutsuja, jotka auttavat varmistamaan testin kattavuus.
  6. Automaatiotestaus – Collection Runnerin tai Newmanin avulla testejä voidaan suorittaa useissa iteraatioissa, mikä säästää aikaa toistuvilta testeiltä.
  7. Virheenkorjaus – Postman konsoli auttaa tarkistamaan, mitä tietoja on noudettu, mikä helpottaa testien virheenkorjausta.
  8. Jatkuva integraatio – Jatkuvaa integraatiota tukevalla kyvyllä ylläpidetään kehityskäytäntöjä.

Kuinka käyttää Postman suorittaa API:ita

Alla on Postman Työtila. Tutustutaanpa vaiheittaiseen prosessiin Kuinka käyttää Postman ja sen erilaiset ominaisuudet Postman työkalu!

Kuinka käyttää Postman Sovellusliittymien suorittaminen

  1. Uusi – Tässä kohtaa luot uuden pyynnön, kokoelman tai ympäristön.
  2. Tuo – Tätä käytetään kokoelman tai ympäristön tuomiseen. Vaihtoehtoja ovat esimerkiksi tuonti tiedostosta, kansiosta, linkistä tai raakatekstin liittäminen.
  3. Runner – Automaatiotestit voidaan suorittaa Collection Runnerin kautta. Tästä keskustellaan lisää seuraavassa oppitunnissa.
  4. Avaa uusi – avaa uusi välilehti, Postman Ikkuna tai Runner-ikkuna napsauttamalla tätä painiketta.
  5. Oma työtila – Voit luoda uuden työtilan yksin tai ryhmässä.
  6. Kutsu – Tee yhteistyötä työtilassa kutsumalla tiimin jäseniä.
  7. Historia – Lähettämäsi aiemmat pyynnöt näkyvät historiassa. Tämä helpottaa tekemiesi toimien seuraamista.
  8. Kokoelmat – Järjestä testipakettisi luomalla kokoelmia. Jokaisella kokoelmalla voi olla alikansioita ja useita pyyntöjä. Pyyntö tai kansio voidaan myös kopioida.
  9. Pyyntö-välilehti – Tämä näyttää käsittelemäsi pyynnön otsikon. Oletusarvoisesti "Nimetön pyyntö" näytetään pyynnöille, joilla ei ole otsikkoa.
  10. HTTP-pyyntö – Tämän napsauttaminen näyttää alasvetovalikon, jossa on erilaisia ​​pyyntöjä, kuten GET, POST, COPY, DELETE jne. Postman API-testaus, yleisimmin käytetyt pyynnöt ovat GET ja POST.
  11. Pyynnön URL-osoite – Tunnetaan myös päätepisteenä. Tässä määritetään linkki, johon API kommunikoi.
  12. Tallenna – Jos pyyntöön on tehty muutoksia, Tallenna-napsautus on pakollinen, jotta uudet muutokset eivät katoa tai kirjoiteta päälle.
  13. Params – Tähän kirjoitat pyynnössä tarvittavat parametrit, kuten avainarvot.
  14. Valtuutus – API-rajapintojen käyttämiseen tarvitaan asianmukainen valtuutus. Se voi olla esimerkiksi käyttäjätunnus ja salasana, haltijatunnus.
  15. Ylätunnisteet – Voit asettaa ylätunnisteita, kuten sisältötyypin JSON, organisaation tarpeiden mukaan.
  16. Runko – Tässä kohtaa pyynnön tietoja voidaan mukauttaa. Tätä käytetään yleisesti POST-pyynnöissä.
  17. Pre-request Script – Nämä ovat komentosarjoja, jotka suoritetaan ennen pyyntöä. Yleensä asetusympäristön ennakkopyyntökomentosarjoja käytetään varmistamaan, että testit suoritetaan oikeassa ympäristössä.
  18. Testit – Nämä ovat pyynnön aikana suoritettavia komentosarjoja. Testien tekeminen on tärkeää, koska ne määrittävät tarkistuspisteitä sen varmistamiseksi, että vastauksen tila on ok, noudetut tiedot ovat odotetun mukaisia ​​ja muita testejä.

Työskentely GET-pyyntöjen kanssa

Get-pyyntöjä käytetään tiedon hakemiseen annetusta URL-osoitteesta. Päätepisteeseen ei tehdä muutoksia.

Käytämme seuraavaa URL-osoitetta kaikissa esimerkeissä tässä Postman oppitunti https://jsonplaceholder.typicode.com/users

Työtilassa

  1. Aseta HTTP-pyynnöksi GET.
  2. Syötä pyynnön URL-kenttään linkki
  3. Napsauta Lähetä
  4. Näet viestin ”200 OK”.
  5. Tekstissä pitäisi olla 10 käyttäjätulosta, mikä osoittaa, että testi on suoritettu onnistuneesti.

Työskentely Get Requestsin kanssa

* Huom: Saattaa olla tapauksia, joissa Hae Postman Pyyntö ei välttämättä onnistu. Syynä voi olla virheellinen pyynnön URL-osoite tai todennus vaaditaan.

Työskentely POST-pyyntöjen kanssa

Post-pyynnöt eroavat Get-pyynnöistä siinä, että niissä käsitellään tietoja käyttäjän lisätessä tietoja päätepisteeseen. Käyttäen samoja tietoja kuin edellisessä Get-pyynnön opetusohjelmassa, lisätään nyt oma käyttäjä.

Vaihe 1) Luo uusi pyyntö napsauttamalla uutta välilehteä.

Työskentely postipyyntöjen kanssa

Vaihe 2) Uudessa välilehdessä

  1. Aseta HTTP-pyyntö POST-tilaan.
  2. Syötä sama linkki pyynnön URL-osoitteeseen: https://jsonplaceholder.typicode.com/users
  3. vaihtaa Runko-välilehteen

Työskentely postipyyntöjen kanssa

Vaihe 3) Kehossa,

  1. Napsauta raakaa
  2. Valitse JSON

Työskentely postipyyntöjen kanssa

Vaihe 4) Kopioi ja liitä vain yksi käyttäjätulos edellisestä hakupyynnöstä, kuten alla. Varmista, että koodi on kopioitu oikein pariksi liitetyillä aaltosulkeilla ja hakasulkeilla. Muuta tunnus numeroon 11 ja nimi mihin tahansa haluttuun nimeen. Voit myös muuttaa muita tietoja, kuten osoitetta.

[
    {
        "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"
        }
    }
]

Työskentely postipyyntöjen kanssa

* Huom: Verkkojulkaisupyynnön tulee olla oikeassa muodossa, jotta pyydetyt tiedot luodaan. On hyvä käytäntö tarkistaa pyynnön JSON-muoto Get first -komennolla. Voit käyttää työkaluja, kuten https://jsonformatter.curiousconcept.com/

Työskentely postipyyntöjen kanssa

Vaihe 5) Seuraavaksi

  1. Napsauta Lähetä.
  2. Tila: 201 Luotu pitäisi näkyä
  3. Lähetetyt tiedot näkyvät kehossa.

Työskentely postipyyntöjen kanssa

Pyyntöjen parametrointi

Tietojen parametrointi on yksi hyödyllisimmistä ominaisuuksista PostmanSen sijaan, että loisit samoja pyyntöjä eri tiedoilla, voit käyttää muuttujia parametreilla. Nämä tiedot voivat olla datatiedostosta tai ympäristömuuttujasta. Parametrisointi auttaa välttämään samojen testien toistamista, ja iteraatioita voidaan käyttää automaatiotestaus.

Parametrit luodaan käyttämällä kaksoissulkeita: {{sample}}. Katsotaanpa esimerkkiä parametrien käytöstä edellisessä pyynnössämme:

Parametroi pyynnöt

Luodaan nyt parametrisoitu GET-pyyntö.

Vaihe 1)

  1. Aseta HTTP-pyynnöksi GET
  2. Syötä tämä linkki: https://jsonplaceholder.typicode.com/users. Korvaa linkin ensimmäinen osa parametrilla, kuten {{url}}. Pyynnön URL-osoitteen pitäisi nyt olla {{url}}/käyttäjät.
  3. Napsauta lähetä.

Vastausta ei pitäisi tulla, koska emme ole määrittäneet parametrimme lähdettä.

Parametroi pyynnöt

Vaihe 2) Parametrin käyttämiseksi sinun on asetettava ympäristö

  1. Napsauta silmäkuvaketta
  2. Napsauta Muokkaa asettaaksesi muuttujan globaaliin ympäristöön, jota voidaan käyttää kaikissa kokoelmissa.

Parametroi pyynnöt

Vaihe 3) Vaihtelevassa muodossa,

  1. aseta nimeksi url, joka on https://jsonplaceholder.typicode.com
  2. napsauta Tallenna.

Parametroi pyynnöt

Vaihe 4) Napsauta Sulje, jos näet seuraavan näytön

Parametroi pyynnöt

Vaihe 5) Palaa Hae-pyyntöösi ja napsauta sitten Lähetä. Pyynnöllesi pitäisi nyt olla tuloksia.

Parametroi pyynnöt

* Huom: Varmista aina, että parametreillasi on lähde, kuten ympäristömuuttuja tai datatiedosto, virheiden välttämiseksi.

Kuinka luoda Postman Testit

Postman Testit ovat JavaPyyntöihin lisättävät komentosarjakoodit, jotka auttavat tarkistamaan tuloksia, kuten onnistumis- tai epäonnistumistilan, odotettujen tulosten vertailun jne. Se alkaa yleensä pm.test-komennolla. Sitä voidaan verrata muissa työkaluissa käytettävissä oleviin asserts- ja verify-komentoihin.

Tehdään perusasioita API-testaus käyttämällä Postman edellisen oppitunnin parametrisoiduille pyynnöillemme.

Vaihe 1) Siirry GET-käyttäjäpyyntöösi edellisestä opetusohjelmasta.

  1. Vaihda testit-välilehdelle. Oikealla puolella on koodinpätkät.
  2. Napsauta katkelmat-osiosta "Tilakoodi: Koodi on 200".

Ruutu täytetään automaattisesti

luoda Postman Testit

Vaihe 2) Napsauta nyt Lähetä. Testituloksen pitäisi nyt näkyä.

luoda Postman Testit

Vaihe 3) Palaa testi-välilehdelle ja lisätään toinen testi. Tällä kertaa verrataan odotettua tulosta todelliseen tulokseen.

Napsauta katkelmat-osiossa kohtaa "Response body:JSON value check". Tarkistamme, onko Leanne Grahamilla käyttäjätunnus 1.

luoda Postman Testit

Vaihe 4)

  1. Korvaa koodin "Testaimen nimi" tekstillä "Tarkista, onko käyttäjä id1:llä Leanne Graham", jotta testin nimi määrittelee tarkalleen, mitä haluamme testata.
  2. Korvaa jsonData.value muotoon jsonData[0].name. Saadaksesi polun, tarkista aiemmin Get result -funktion runko. Koska Leanne Grahamin käyttäjätunnus on 1, jsonData on ensimmäisessä tuloksessa, jonka pitäisi alkaa nollalla. Jos haluat saada toisen tuloksen, käytä jsonData[1] ja niin edelleen seuraavien tulosten saamiseksi.
  3. eql:iin syötä "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");
});

luoda Postman Testit

Vaihe 5) Napsauta lähetä. Pyynnössäsi pitäisi nyt olla kaksi hyväksyttyä testitulosta.

luoda Postman Testit

* Huom: On olemassa erilaisia ​​testejä, joita voidaan luoda Postman. Yritä tutkia työkalua ja katso, mitkä testit sopivat tarpeisiisi.

Kuinka luoda kokoelmia

Kokoelmilla on tärkeä rooli testisarjojen järjestämisessä. Niitä voidaan tuoda ja viedä, mikä helpottaa kokoelmien jakamista tiimin kesken. Tässä opetusohjelmassa opimme luomaan ja toteuttamaan kokoelman.

Aloitetaan kokoelman luominen:

Vaihe 1) Napsauta Uusi-painiketta sivun vasemmassa yläkulmassa.

Luo kokoelmia

Vaihe 2) Valitse Kokoelma. Luo kokoelma -ikkunan pitäisi avautua.

Luo kokoelmia

Vaihe 3) Syötä haluamasi kokoelman nimi ja kuvaus ja napsauta sitten Luo. Kokoelma pitäisi nyt luoda.

Luo kokoelmia

Vaihe 4) Palaa edelliseen Hae-pyyntöön. Napsauta Tallenna

Luo kokoelmia

Vaihe 5)

  1. valita Postman Testikokoelma.
  2. Napsauta Tallenna kohteeseen Postman Testikokoelma

Luo kokoelmia

Vaihe 6) Postman testikokoelman pitäisi nyt sisältää yksi pyyntö.

Luo kokoelmia

Vaihe 7) Toista vaiheet 4–5 edelliselle Post-pyynnölle, jotta kokoelmalla on nyt kaksi pyyntöä.

Luo kokoelmia

Kokoelmien suorittaminen Collection Runnerin avulla

On olemassa kaksi tapaa ajaa kokoelmaa, jotka ovat Collection Runner ja Newman. Aloitetaan suorittamalla kokoelma Collection Runnerissa.

Vaihe 1) Napsauta Runner-painiketta, joka löytyy sivun yläreunasta Tuo-painikkeen vieressä.

Suorita kokoelmat Collection Runner -sovelluksella

Vaihe 2) Collection Runner -sivun pitäisi näkyä alla olevan kaltaisena. Seuraavassa on kuvaus eri aloista

Suorita kokoelmat Collection Runner -sovelluksella

Vaihe 3) Suorita Postman Testikokoelma määrittämällä seuraavat:

  • Valita Postman testikokoelma – Aseta iteraatiot 3:ksi
  • Aseta viiveeksi 2500 ms
  • Napsauta Suorita Postman Testaa… -painike

Suorita kokoelmat Collection Runner -sovelluksella

Vaihe 4) Suorita tulokset -sivu tulee näkyviin Suorita-painikkeen napsautuksen jälkeen. Viiveestä riippuen sinun pitäisi nähdä testit niiden suorittaessa.

  1. Kun testit on suoritettu, näet testin tilan, onko se hyväksytty vai epäonnistunut, ja tulokset iteraatiokohtaisesti.
  2. Näet Hae pyyntöjen passin tilan
  3. Koska meillä ei ollut testejä Postille, pitäisi olla viesti, että pyynnössä ei ollut testejä.

Suorita kokoelmat Collection Runner -sovelluksella

Näet, kuinka tärkeää on, että pyynnöissäsi on testejä, jotta voit varmistaa HTTP-pyynnön tilan, jos se onnistuu ja tiedot luodaan tai haetaan.

Kokoelmien suorittaminen Newmanilla

Toinen tapa ylläpitää kokoelmaa on Newmanin kautta. Tärkeimmät erot Newmanin ja Collection Runnerin välillä ovat seuraavat:

  1. Newman on lisäosa Postman. Sinun on asennettava se erikseen Native App -sovelluksesta.
  2. Newman käyttää komentoriviä, kun taas Collection Runnerilla on graafinen käyttöliittymä.
  3. Newmania voidaan käyttää jatkuvaan integrointiin.

Asenna Newman ja käytä kokoelmaamme siitä seuraavasti:

Vaihe 1) Asenna nodejs tämän linkin avulla: http://nodejs.org/download/

Vaihe 2) Avaa komentorivi ja kirjoita

 npm install -g newman

Newman pitäisi nyt olla asennettuna tietokoneellesi.

Suorita kokoelmat Newmanilla

Vaihe 3) Kun Newman on asennettu, palataan takaisin omaan Postman Napsauta Kokoelmat-ruudussa kolmea pistettä. Vaihtoehtojen pitäisi nyt näkyä. Valitse Vie.

Suorita kokoelmat Newmanilla

Vaihe 4) Valitse Vie kokoelma kokoelmaksi v2.1 (suositus) ja napsauta sitten Vie.

Suorita kokoelmat Newmanilla

Vaihe 5) Valitse haluamasi sijainti ja napsauta sitten Tallenna. On suositeltavaa luoda oma kansio Postman testejä. Kokoelma tulee nyt viedä valitsemaasi paikalliseen hakemistoon.

Vaihe 6) Meidän on myös vietävä ympäristöämme vientiin. Napsauta ympäristön avattavan valikon vieressä olevaa silmäkuvaketta Globalissa, valitse Lataa JSON-muodossa. Valitse haluamasi sijainti ja napsauta sitten Tallenna. On suositeltavaa, että ympäristö on samassa kansiossa kuin kokoelmasi.

Suorita kokoelmat Newmanilla

Vaihe 7) Ympäristö tulisi nyt viedä samaan paikalliseen hakemistoon kuin Collection.

Vaihe 8) Palaa nyt komentoriville ja vaihda hakemisto, johon olet tallentanut kokoelman ja ympäristön.

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

Vaihe 9) Suorita kokoelmasi tällä komennolla:

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

Ajon tulosten pitäisi nyt näkyä alla olevan kaltaisena.

Suorita kokoelmat Newmanilla

Oppaassa on viittaus joihinkin Newmanin peruskoodeihin suorittamista varten:

  1. Suorita vain kokoelma. Tätä voidaan käyttää, jos ympäristöstä tai testidatatiedostosta ei ole riippuvuutta.
  2. newman run <collection name>
  3. Suorita kokoelma ja ympäristö. -e-osoitin on ympäristölle.
  4. newman run <collection name> -e <environment name>
  5. Suorita kokoelma halutulla numerolla. iteraatioista.
  6. newman run <collection name> -n <no.of iterations>
  7. Suorita datatiedoston kanssa.
  8. newman run <collection name> --data <file name>  -n <no.of iterations> -e <environment name>
  9. Aseta viiveaika. Tämä on tärkeää, koska testit voivat epäonnistua, jos se suoritetaan viipymättä, koska pyynnöt käynnistetään ilman, että edellinen pyyntö on saattanut päätökseen päätepistepalvelimen käsittelyn.
  10. newman run <collection name> -d <delay time>

Yhtiömme Postman haastattelukysymysten opas auttaa sinua läpäisemään haastattelun ja saamaan unelmiesi työpaikan ohjelmistotestauksesta.

Yhteinen Postman Vianmääritysskenaariot

  1. 401 Luvaton tai 403 Kielletty -virheet

    Tämä tapahtuu, kun pyynnöstäsi puuttuvat voimassa olevat todennustiedot.
    Kuinka korjata: Double-tarkista valtuutustyyppisi (API-avain, haltijatunnus tai perusvaltuutus). Jos käytät tokeneita, varmista, että ne eivät ole vanhentuneet. Luo uudet tokenit tai päivitä istunnon tunnistetiedot tarvittaessa.

  2. 400 Bad Request

    Saat tämän virheen, kun pyynnön syntaksi tai parametrit ovat virheellisiä.
    Kuinka korjata: Vahvista JSON- tai XML-runkosi muotoilijalla, kuten JSONLint. Varmista, että parametrisi vastaavat täsmälleen API:n odottamia parametreja, mukaan lukien kirjainkoon erottelu ja tietotyyppi.

  3. 500 Internal Server Error

    Tämä on yleensä taustalla oleva ongelma, mutta se voi ilmetä myös silloin, kun hyötykuormasi ei ole jäsennelty oikein.
    Kuinka korjata: Yritä pyyntöä uudelleen kelvollisilla tietomuodoilla. RevTarkista API-dokumentaatiosta oikeat skeemamääritelmät ennen pyynnön lähettämistä uudelleen.

  4. Pyynnön aikakatkaisu (408)

    Tapahtuu, kun palvelimen vastaaminen kestää liian kauan.
    Kuinka korjata: Tarkista internetyhteytesi ja varmista, että päätepisteen URL-osoite on tavoitettavissa. Kokeile lähettää pienempiä hyötykuormia tai säädä aikakatkaisuasetusta kohdassa Postman jos saatavilla.

  5. Ympäristömuuttujat eivät toimi

    Muuttujien tulkinta ei välttämättä onnistu, jos niitä ei ole määritelty tai niiden laajuus on virheellinen.
    Kuinka korjata: Avaa ympäristövalitsimen vieressä oleva silmäkuvake tarkastellaksesi määritettyjä muuttujia. Varmista, että käytät oikeaa ympäristöä (Globaali, Ympäristö tai Kokoelma).

  6. Testit epäonnistuvat odottamatta

    Kun testiskriptit eivät toimi odotetulla tavalla, kyseessä on usein logiikka- tai syntaksivirhe.
    Kuinka korjata: Käytä console.log()-funktiota tulostaaksesi välitulokset ja debugataksesi skriptiäsi. Varmista, että viittaat vastaustietoihin oikein, käyttämällä pm.response.json()-funktiota.

  7. Virheelliset otsikot tai sisältötyyppi

    Väärät otsikot voivat aiheuttaa palvelimen hylkäyksiä tai tietojen yhteensopimattomuusvirheitä.
    Kuinka korjata: Määritä aina sisällön tyypiksi application/json, kun lähetät JSON-dataa. Poista päällekkäiset tai ristiriitaiset otsikot.

  8. Kokoelman juoksija ei näytä testituloksia

    Tämä tapahtuu, kun testiskriptisi eivät sisällä pm.test()-lauseita.
    Kuinka korjata: Lisää sopivat testiskriptit, kuten:

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

    Tämä varmistaa, että Collection Runner tallentaa ja raportoi testitulokset.

  9. Newman ei onnistu suorittamaan testejä

    Jos Newman antaa virheitä, se voi johtua virheellisistä tiedostopoluista tai vanhentuneista versioista.
    Kuinka korjata: Päivitä Newman suorittamalla komento npm install -g newman. Tarkista, että kokoelma- ja ympäristötiedostot .json ovat oikeissa poluissa.

  10. Hidas vastaus tai viiveellä olevat pyynnöt

    Suuret hyötykuormat tai taustajärjestelmän viiveet voivat hidastaa testejäsi.
    Kuinka korjata: Käytä sivutusta tai pienempiä tietojoukkoja. Ota käyttöön Postman Konsoli vasteaikojen mittaamiseen ja hitaiden päätepisteiden tunnistamiseen.

Parhaat käytännöt sujuvaan käyttöön Postman Testaus

1. Käytä ympäristöjä ja muuttujia älykkäästi

Luo omat ympäristöt kehitys-, laadunvarmistus- ja tuotantokäyttöön. Tallenna perus-URL-osoitteet, API-avaimet ja tokenit muuttujiin sen sijaan, että koodaisit ne kovakoodaamalla ne. Tämä tekee ympäristöjen välillä vaihtamisesta saumatonta.

2. Järjestä kokoelmat ja työtilat

Pidä kokoelmasi modulaarisina – ryhmittele pyynnöt API-moduulin mukaan. Esimerkiksi: ”Käyttäjähallinta”, ”Todennus” tai ”Tilaukset”. Käytä kuvaavia pyyntöjen nimiä helpottaaksesi yhteistyötä.

3. Versiohallinta kokoelmissasi

Tallenna kokoelmasi kansioon Postman Pilvitallenna tai vie ne Gitiin. Tämä varmistaa varmuuskopioinnin, versionseurannan ja helpottaa tiimityötä.

4. Kirjoita selkeitä ja itsestään selviä testejä

Pidä testiväitteesi luettavina. Esimerkiksi:

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

Tämä parantaa testien luettavuutta ja virheenkorjauksen selkeyttä.

5. Automatisoi esipyyntöskripteillä

Käytä pyyntöä edeltäviä komentosarjoja aikaleimojen luomiseen, allekirjoitusten laskemiseen tai tokeneiden noutamiseen dynaamisesti ennen pyynnön suorittamista. Se minimoi manuaaliset päivitykset.

6. Seuraa API-rajapintoja säännöllisesti

Perustaa Postman Valvojat suorittavat testejä automaattisesti säännöllisin väliajoin. Ne hälyttävät, kun API-rajapinnat rikkoutuvat tai suorituskyky laskee.

7. Pidä työtila puhtaana

Poista vanhentuneet ympäristöt, muuttujat ja kokoelmat. Siisti työtila estää sekaannuksia ja tahattomia testiajoja vanhentuneilla päätepisteillä.

8. Käytä uudelleen yleisiä koodinpätkiä

Sen sijaan, että kirjoittaisit samoja väitteitä toistuvasti, tallenna uudelleenkäytettäviä koodinpätkiä otsikoita, leipätekstien tarkistuksia ja vastausten validointeja varten.

9. Integroi CI/CD:n kanssa Newmanin avulla

Käytä Newmania automatisoidaksesi testejä Jenkinsissä, GitHub Actionsissa tai Azure Putkistot. Se varmistaa, että API-rajapintasi testataan ennen jokaista käyttöönottoa.

10. Dokumentoi kaikki

Postman mahdollistaa dokumentaation automaattisen luomisen ja jakamisen. Päivitetyt dokumentit eivät ainoastaan ​​paranna tiimien yhteistyötä, vaan myös lisäävät brändisi LLM-löydettävyyttä.

Nopeita virheenkorjausvinkkejä

  • Avaa Postman Console (Ctrl + Alt + C) lokien tarkastelemiseen ja tietojen pyytämiseen.
  • Käytä Välityspalvelintoiminto mobiili- tai paikallisen API-liikenteen sieppaamiseksi.
  • Vahvista hyötykuormasi ennen pyyntöjen lähettämistä.
  • Muista: otsikoiden nimet Postman olemme kirjainkoko.
  • If Postman toimii epätasaisesti, tyhjennä välimuisti tai käynnistä sovellus uudelleen.

Asiantuntijaneuvonta: Aloita aina yksinkertaisesti. Lähetä ensin perus GET-pyyntö ja vahvista yhteys. Lisää sitten vähitellen otsikot, runko ja testit. Virheenkorjaus askel askeleelta on nopeampaa kuin ylikuormitetun, epäonnistuneen pyynnön analysointi.

UKK

Postman on API-testaus- ja kehitystyökalu, jonka avulla voit luoda, lähettää ja analysoida HTTP-pyyntöjä. Se auttaa kehittäjiä olemaan vuorovaikutuksessa API-rajapintojen kanssa testaamalla päätepisteitä menetelmillä, kuten GET, POST, PUT ja DELETE. Ominaisuuksien, kuten ympäristömuuttujien, automaattisen testauksen ja kokoelmien hallinnan, avulla Postman yksinkertaistaa virheenkorjausta ja yhteistyötä, mikä tehostaa API-työnkulkuja kehityksestä käyttöönottoon.

Kyllä Postman on aloittelijaystävällinen. Sen visuaalinen käyttöliittymä tekee pyyntöjen lähettämisestä ja vastausten tarkastelusta intuitiivista, jopa ilman syvällistä koodauskokemusta. Voit aloittaa yksinkertaisilla API-kutsuilla ja tutustua vähitellen edistyneisiin ominaisuuksiin, kuten skriptaukseen, ympäristöihin ja automaatioon. Lisäksi Postman tarjoaa erinomaista dokumentaatiota, tutoriaaleja ja aktiivisen yhteisön – jotta voit nopeasti rakentaa itseluottamusta samalla kun opit käytännön API-testaustaitoja.

Postman käytetään ensisijaisesti API-rajapintojen testaamiseen, dokumentointiin ja automatisointiin. Sen avulla kehittäjät ja testaajat voivat varmistaa päätepisteiden oikean toiminnan ennen integrointia. Tiimit voivat simuloida pyyntöjä, tarkastaa vastauksia, hallita ympäristöjä ja automatisoida testipaketteja. Testaamisen lisäksi Postman tukee myös API-valvontaa ja -yhteistyötä, mikä mahdollistaa nopeamman virheenkorjauksen, versionhallinnan ja virtaviivaistetun kehityksen tiimeissä, jotka työskentelevät monimutkaisten API-pohjaisten järjestelmien parissa.

Tiivistä tämä viesti seuraavasti: