Postman Opetusohjelma – Kuinka käyttää API-testaukseen?

Mikä on Postman?

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

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äytettäväksi Postman työkalu, sinun tarvitsee vain kirjautua sisään omille tileilleen, jolloin tiedostojen käyttö on helppoa milloin tahansa ja missä tahansa niin kauan kuin Postman sovellus on asennettu tietokoneeseen.
2. Kokoelmien käyttö – Postman antaa käyttäjien luoda kokoelmia itselleen Postman API-kutsut. Jokainen kokoelma voi luoda alikansioita ja useita pyyntöjä. Tämä auttaa järjestämään testisarjasi.
3. Yhteistyö – Kokoelmia ja ympäristöjä voidaan tuoda tai viedä, mikä tekee tiedostojen jakamisesta helppoa. Suoraa linkkiä voidaan käyttää myös kokoelmien jakamiseen.
4. Ympäristöjen luominen – Useiden ympäristöjen käyttö vähentää testien toistoa, koska voidaan käyttää samaa kokoelmaa mutta eri ympäristössä. Tässä tapahtuu parametrointi, josta keskustelemme lisätunteilla.
5. Testien luominen – Testien tarkistuspisteitä, kuten onnistuneen HTTP-vastauksen tilan varmistaminen, voidaan lisätä kuhunkin Postman API-kutsut, jotka auttavat varmistamaan testin kattavuus.
6. Automaatiotestaus – Collection Runnerin tai Newmanin avulla testejä voidaan suorittaa useissa iteraatioissa, mikä säästää aikaa toistuviin testeihin.
7. Virheenkorjaus – Postman konsoli auttaa tarkistamaan, mitä tietoja on haettu, 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. Tutkitaan vaihe vaiheelta prosessia Kuinka käyttää Postman ja sen erilaiset ominaisuudet Postman työkalu!

1. Uusi – Täällä voit luoda uuden pyynnön, kokoelman tai ympäristön.
2. Tuo – Tätä käytetään kokoelman tai ympäristön tuomiseen. On olemassa vaihtoehtoja, kuten tuonti tiedostosta, kansiosta, linkistä tai liitä raakateksti.
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 Window 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 monistaa.
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 tuo näkyviin avattavan luettelon erilaisista pyynnöistä, 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ä, josta voit tunnistaa linkin, 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. Parametrit – Tänne kirjoitat pyyntöön tarvittavat parametrit, kuten avainarvot.
14. Valtuutus – Sovellusliittymien käyttö edellyttää asianmukaista valtuutusta. Se voi olla käyttäjänimen ja salasanan, siirtotien tunnuksen jne. muodossa.
15. Otsikot – Voit määrittää otsikot, kuten sisältötyyppi JSON, organisaation tarpeiden mukaan.
16. Body – Tässä voit mukauttaa POST-pyynnössä yleisesti käytetyn pyynnön tietoja.
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 skriptejä, jotka suoritetaan pyynnön aikana. Testien tekeminen on tärkeää, sillä se asettaa tarkistuspisteitä varmistaakseen, että vastauksen tila on kunnossa, haetut tiedot ovat odotettuja ja muita testejä.

Työskentely GET-pyyntöjen kanssa

Hakupyyntöjä käytetään tietojen 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ä linkki pyynnön URL-osoitekenttään
3. Napsauta Lähetä
4. Näet 200 OK -viestin
5. Tekstissä pitäisi olla 10 käyttäjätulosta, jotka osoittavat, että testi on suoritettu onnistuneesti.

* Huom: Saattaa olla tapauksia, joissa Get Postman pyyntö saattaa epäonnistua. Se voi johtua virheellisestä pyynnön URL-osoitteesta tai todennusta tarvitaan.

Työskentely POST-pyyntöjen kanssa

Lähetyspyynnöt eroavat Get-pyynnöstä, koska tietoja käsitellään käyttäjän lisääessä tietoja päätepisteeseen. Lisätään nyt oma käyttäjä käyttämällä samoja tietoja edellisestä Get-pyynnön opetusohjelmasta.

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

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

Vaihe 3) Kehossa,

1. Napsauta raakaa
2. Valitse JSON

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": "Sincere@april.biz",
        "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"
        }
    }
]

* Huom: Online-postituspyynnön tulee olla oikeassa muodossa, jotta voidaan varmistaa, että pyydetyt tiedot luodaan. On hyvä käytäntö käyttää Get first -toimintoa tarkistaaksesi pyynnön JSON-muodon. Voit käyttää työkaluja, kuten https://jsonformatter.curiousconcept.com/

Vaihe 5) Seuraavaksi

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

Pyyntöjen parametrointi

Tietojen parametrointi on yksi hyödyllisimmistä ominaisuuksista Postman. Sen sijaan, että luot samoja pyyntöjä eri tiedoilla, voit käyttää muuttujia parametreilla. Nämä tiedot voivat olla tietotiedostosta 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:

Luodaan nyt parametrize 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ä.

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.

Vaihe 3) Vaihtelevassa muodossa,

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

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

Vaihe 5) Palaa Hae-pyyntöön ja napsauta sitten Lähetä. Pyyntöllesi pitäisi nyt löytyä tuloksia.

* 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ätyt komentosarjakoodit, jotka auttavat sinua tarkistamaan tulokset, kuten onnistuneen tai epäonnistuneen tilan, odotettujen tulosten vertailun jne. Se alkaa yleensä pm.testillä. Sitä voidaan verrata muissa työkaluissa oleviin väitteisiin, verifiointikomentoihin.

Tehdään perusasioita API-testaus käyttämällä Postman edellisen oppitunnin parametrointipyyntöihimme.

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

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

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.

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 arvolla jsonData[0].name. Saadaksesi polun tarkista runko kohdasta Hae tulos aikaisemmin. Koska Leanne Graham on käyttäjätunnus 1, jsonData on ensimmäisessä tuloksessa, jonka pitäisi alkaa nollalla. Jos haluat saada toisen tuloksen, käytä jsonData[0] ja niin edelleen seuraaviin tuloksiin.
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");
});

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

* 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 testipakettien järjestämisessä. Sitä voidaan tuoda ja viedä, jolloin kokoelmien jakaminen tiimin kesken on helppoa. Tässä opetusohjelmassa opimme luomaan ja toteuttamaan kokoelman.

Aloitetaan kokoelman luominen:

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

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

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

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

Vaihe 5)

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

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

Vaihe 7) Toista vaiheet 4–5 edelliselle lähetyspyynnölle, jotta kokoelmassa on nyt kaksi pyyntöä.

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ä.

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

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

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ä.

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.

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

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

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.

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.

Ohjeessa on viittaus joihinkin Newman-peruskoodeihin suorittamista varten:

1. Suorita vain kokoelma. Tätä voidaan käyttää, jos ympäristöstä tai testidatatiedostosta ei ole riippuvuutta.

newman run <collection name>

2. Suorita kokoelma ja ympäristö. -e-osoitin on ympäristölle.

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

3. Suorita kokoelma halutulla numerolla. iteraatioista.

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

4. Suorita datatiedoston kanssa.

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

5. 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.

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

Yhtiömme Postman haastattelukysymysten opas auttaa sinua murtamaan haastattelun ja auttaa sinua saamaan unelmatyösi ohjelmistotestausta varten.

Yhteenveto

• API-testaus käyttäen Postman: Postman on sovellus API-testaukseen. Postman on yksi suosituimmista työkaluista, joita käytetään API-testauksessa lähettämällä pyyntöjä verkkopalvelimelle ja saamalla vastauksen takaisin
• Helppokäyttöisyys, kokoelmien käyttö, yhteistyö, jatkuva integrointi ovat joitakin keskeisiä ominaisuuksia Postman
• On suositeltavaa luoda tili Postman, joten kokoelmasi ovat saatavilla verkossa
• Pyynnön voi parametroida sisään Postman
• Voit luoda testejä postinkantajapyynnön vahvistamiseksi
• Kokoelmia voidaan ajaa Newmanilla tai Collection Runnerilla