Postman tutorial

Ce Este Postman?

Postman este un instrument scalabil de testare API care se integrează rapid într-un pipeline CI/CD. A început în 2012 ca un proiect secundar al lui Abhinav Asthana pentru a simplifica fluxul de lucru API în testare și dezvoltare. API este prescurtarea de la Application Programming Interface (Interfață de Programare a Aplicațiilor), care permite aplicațiilor software să comunice între ele prin apeluri API.

👉 Înscrie-te pentru un proiect gratuit de testare API live

De ce folosiți Postman?

Cu peste 4 milioane de utilizatori în prezent, Postman Software-ul a devenit un instrument de alegere din următoarele motive:

1. Accesibilitate – Pentru a utiliza Postman instrument, ar trebui doar să te conectezi la propriile conturi, facilitând accesul la fișiere oricând, oriunde, atâta timp cât un Postman aplicația este instalată pe computer.
2. Utilizarea colecțiilor – Postman permite utilizatorilor să creeze colecții pentru lor Postman Apeluri API. Fiecare colecție poate crea subfoldere și cereri multiple. Acest lucru ajută la organizarea suitelor de teste.
3. Colaborare – Colecțiile și mediile pot fi importate sau exportate, facilitând partajarea fișierelor. De asemenea, se poate utiliza un link direct pentru partajarea colecțiilor.
4. Crearea mediilor – Existența mai multor medii ajută la reducerea repetării testelor, deoarece se poate utiliza aceeași colecție, dar pentru un mediu diferit. Aici va avea loc parametrizarea, lucru pe care îl vom discuta în lecțiile ulterioare.
5. Crearea de teste – Punctele de control ale testelor, cum ar fi verificarea stării răspunsului HTTP cu succes, pot fi adăugate la fiecare Postman Apelurile API, care ajută la asigurarea acoperirea testului.
6. Testare automatizată – Prin utilizarea Collection Runner sau Newman, testele pot fi rulate în mai multe iterații, economisind timp pentru testele repetitive.
7. Depanare - Postman Consola ajută la verificarea datelor care au fost recuperate, facilitând depanarea testelor.
8. Integrare continuă – Cu capacitatea sa de a sprijini integrarea continuă, practicile de dezvoltare sunt menținute.

Cum să utilizați Postman pentru a executa API-uri

Mai jos este Postman Spațiu de lucru. Să explorăm procesul pas cu pas pe Cum să utilizați Postman și diferite caracteristici ale Postman instrument!

1. Nou – Aici veți crea o nouă cerere, o colecție sau un mediu nou.
2. Import – Această funcție este utilizată pentru a importa o colecție sau un mediu. Există opțiuni precum importul din fișier, folder, link sau lipirea textului brut.
3. Runner – Testele de automatizare pot fi executate prin Collection Runner. Acest lucru va fi discutat în continuare în lecția următoare.
4. Deschideți nou - Deschideți o filă nouă, Postman Fereastră sau Fereastră Runner făcând clic pe acest buton.
5. Spațiul meu de lucru – Puteți crea un nou spațiu de lucru individual sau în echipă.
6. Invitați – Colaborați la un spațiu de lucru invitând membrii echipei.
7. Istoric – Solicitările anterioare pe care le-ați trimis vor fi afișate în Istoric. Acest lucru facilitează urmărirea acțiunilor pe care le-ați efectuat.
8. Colecții – Organizați-vă suita de teste prin crearea de colecții. Fiecare colecție poate avea subfoldere și mai multe cereri. O cerere sau un folder poate fi, de asemenea, duplicat.
9. Fila Solicitare – Aceasta afișează titlul cererii la care lucrați. În mod implicit, „Solicitare fără titlu” va fi afișată pentru solicitările fără titluri.
10. Cerere HTTP – Dacă faceți clic pe aceasta, se va afișa o listă derulantă cu diferite cereri, cum ar fi GET, POST, COPY, DELETE etc. În Postman Testarea API, cele mai frecvent utilizate solicitări sunt GET și POST.
11. URL-ul solicitării – Cunoscut și sub denumirea de punct final, aici veți identifica linkul cu care va comunica API-ul.
12. Salvare – Dacă există modificări la o solicitare, este obligatoriu să faceți clic pe Salvare, astfel încât noile modificări să nu fie pierdute sau suprascrise.
13. Parametri – Aici veți scrie parametrii necesari pentru o cerere, cum ar fi valorile cheii.
14. Autorizare – Pentru a accesa API-urile, este necesară o autorizare corespunzătoare. Aceasta poate fi sub forma unui nume de utilizator și a unei parole, a unui token de purtător etc.
15. Anteturi – Puteți seta anteturi precum tipul de conținut JSON, în funcție de nevoile organizației.
16. Corp – Aici se pot personaliza detaliile dintr-o cerere, utilizat în mod obișnuit într-o cerere POST.
17. Pre-request Script – Acestea sunt scripturi care vor fi executate înainte de solicitare. De obicei, scripturile de pre-cerere pentru mediul de setare sunt folosite pentru a se asigura că testele vor fi rulate în mediul corect.
18. Teste – Acestea sunt scripturi executate în timpul solicitării. Este important să existe teste, deoarece acestea configurează puncte de control pentru a verifica dacă starea răspunsului este corectă, dacă datele preluate sunt conform așteptărilor și alte teste.

Lucrul cu solicitările GET

Cererile de tip „get” sunt folosite pentru a prelua informații de la adresa URL dată. Nu se vor face modificări la punctul final.

Vom folosi următorul URL pentru toate exemplele din aceasta Postman tutorial https://jsonplaceholder.typicode.com/users

În spațiul de lucru

1. Setați solicitarea HTTP la GET.
2. În câmpul URL al solicitării, introduceți linkul
3. Faceți clic pe Trimite
4. Veți vedea un mesaj „200 OK”
5. Ar trebui să existe 10 rezultate ale utilizatorilor în corp, ceea ce indică faptul că testul a fost efectuat cu succes.

*Notă: Pot exista cazuri în care Get Postman Este posibil ca solicitarea să nu reușească. Acest lucru se poate datora unei adrese URL de solicitare nevalide sau este necesară autentificarea.

Lucrul cu solicitări POST

Cererile Post sunt diferite de cererile Get, deoarece există o manipulare a datelor, utilizatorul adăugând date la endpoint. Folosind aceleași date din tutorialul anterior din cererea Get, haideți să adăugăm acum propriul nostru utilizator.

Pas 1) Faceți clic pe o filă nouă pentru a crea o nouă solicitare.

Pas 2) În noua filă

1. Setați solicitarea HTTP la POST.
2. Introduceți același link în adresa URL a solicitării: https://jsonplaceholder.typicode.com/users
3. comutați la fila Corp

Pas 3) În corp,

1. Faceți clic pe raw
2. Selectați JSON

Pas 4) Copiați și inserați doar un rezultat de utilizator din cererea anterioară de obținere, ca mai jos. Asigurați-vă că codul a fost copiat corect cu acolade și paranteze pereche. Schimbați id-ul la 11 și numele cu orice nume dorit. Puteți modifica și alte detalii, cum ar fi adresa.

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

*Notă: Cererea de postare online ar trebui să aibă formatul corect pentru a asigura crearea datelor solicitate. Este o practică bună să utilizați Get first pentru a verifica formatul JSON al cererii. Puteți utiliza instrumente precum https://jsonformatter.curiousconcept.com/

Pas 5) În continuare,

1. Faceți clic pe Trimiteți.
2. Stare: 201 Creat ar trebui să fie afișat
3. Datele postate apar în corp.

Cum să parametrizați cererile

Parametrizarea datelor este una dintre cele mai utile caracteristici ale PostmanÎn loc să creați aceleași cereri cu date diferite, puteți utiliza variabile cu parametri. Aceste date pot proveni dintr-un fișier de date sau dintr-o variabilă de mediu. Parametrizarea ajută la evitarea repetării acelorași teste, iar iterațiile pot fi utilizate pentru testarea automatizării.

Parametrii sunt creați prin utilizarea parantezelor duble: {{eșantion}}. Să aruncăm o privire la un exemplu de utilizare a parametrilor în solicitarea noastră anterioară:

Acum să creăm o cerere GET parametrizată.

Pas 1)

1. Setați solicitarea HTTP la GET
2. Introduceți acest link: https://jsonplaceholder.typicode.com/users. Înlocuiți prima parte a linkului cu un parametru precum {{url}}. Adresa URL a cererii ar trebui să fie acum {{url}}/utilizatori.
3. Faceți clic pe trimite.

Nu ar trebui să existe niciun răspuns, deoarece nu am setat sursa parametrului nostru.

Pas 2) Pentru a utiliza parametrul trebuie să setați mediul

1. Faceți clic pe pictograma ochiului
2. Faceți clic pe editare pentru a seta variabila la un mediu global, care poate fi utilizat în toate colecțiile.

Pas 3) In variabila,

1. setați numele la adresa URL care este https://jsonplaceholder.typicode.com
2. faceți clic pe Salvare.

Pas 4) Faceți clic pe închidere dacă vedeți următorul ecran

Pas 5) Reveniți la solicitarea dvs. Obțineți, apoi faceți clic pe Trimitere. Acum ar trebui să existe rezultate pentru solicitarea dvs.

*Notă: Asigurați-vă întotdeauna că parametrii au o sursă, cum ar fi o variabilă de mediu sau un fișier de date, pentru a evita erorile.

Cum se creează Postman Teste

Postman Testele sunt JavaCoduri script adăugate la cereri care vă ajută să verificați rezultatele, cum ar fi statusul de succes sau eșuat, compararea rezultatelor așteptate etc. De obicei, începe cu pm.test. Poate fi comparat cu asserts, comenzi de verificare disponibile în alte instrumente.

Să facem niște elemente de bază Testare API folosind Postman pentru cererile noastre parametrizate din lecția anterioară.

Pas 1) Accesați solicitarea dvs. de utilizator GET din tutorialul anterior.

1. Treceți la fila de teste. În partea dreaptă sunt coduri de fragmente.
2. Din secțiunea de fragmente, faceți clic pe „Codul de stare: codul este 200”.

Panoul este completat automat

Pas 2) Acum faceți clic pe Trimitere. Rezultatul testului ar trebui acum să fie afișat.

Pas 3) Reveniți la fila de testare și să adăugăm un alt test. De data aceasta vom compara rezultatul așteptat cu rezultatul real.

Din secțiunea de fragmente, faceți clic pe „Corpul răspunsului: verificarea valorii JSON”. Vom verifica dacă Leanne Graham are userid 1.

Pas 4)

1. Înlocuiți „Numele testului” din cod cu „Verificați dacă utilizatorul cu id1 este Leanne Graham”, astfel încât numele testului să specifice exact ceea ce vrem să testăm.
2. Înlocuiți jsonData.value cu jsonData[0].name. Pentru a obține calea, verificați corpul în Get result mai devreme. Deoarece Leanne Graham are ID-ul utilizator 1, jsonData se află în primul rezultat, care ar trebui să înceapă cu 0. Dacă doriți să obțineți al doilea rezultat, utilizați jsonData[1] și așa mai departe pentru rezultatele următoare.
3. În eql, introduceți „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");
});

Pas 5) Faceți clic pe trimite. Ar trebui să existe acum două rezultate de test trecute pentru solicitarea dvs.

*Notă: Există diferite tipuri de teste care pot fi create în Postman. Încercați să explorați instrumentul și să vedeți ce teste se potrivesc nevoilor dvs.

Cum se creează colecții

Colecțiile joacă un rol important în organizarea seturilor de teste. Acestea pot fi importate și exportate, facilitând partajarea colecțiilor în cadrul echipei. În acest tutorial, vom învăța cum să creăm și să executăm o colecție.

Să începem să creăm o colecție:

Pas 1) Faceți clic pe butonul Nou din colțul din stânga sus al paginii.

Pas 2) Selectați Colecție. Ar trebui să apară fereastra Creare colecție.

Pas 3) Introduceți numele și descrierea colecției dorite, apoi faceți clic pe creați. Acum ar trebui creată o colecție.

Pas 4) Reveniți la solicitarea anterioară Obțineți. Faceți clic pe Salvare

Pas 5)

1. Selectați Postman Colecția de teste.
2. Faceți clic pe Salvați în Postman Colecția de teste

Pas 6) Postman colecția de teste ar trebui să conțină acum o singură solicitare.

Pas 7) Repetați pașii 4-5 pentru solicitarea Post anterioară, astfel încât colecția să aibă acum două solicitări.

Cum să rulați colecții folosind Collection Runner

Există două moduri de a rula o colecție, care este Collection Runner și Newman. Să începem prin a executa colecția în Collection Runner.

Pas 1) Faceți clic pe butonul Runner aflat în partea de sus a paginii lângă butonul Import.

Pas 2) Pagina Runner de colecție ar trebui să apară ca mai jos. Mai jos este descrierea diferitelor domenii

Pas 3) Rulați-vă Postman Testați colecția prin configurarea următoarelor:

• Alege Postman colecție de teste - Setați iterațiile ca 3
• Setați întârzierea la 2500 ms
• Faceți clic pe Run Postman Butonul de testare...

Pas 4) Pagina Run Results ar trebui să fie afișată după ce faceți clic pe butonul Run. În funcție de întârziere, ar trebui să vedeți testele pe măsură ce se execută.

1. Odată ce testele s-au terminat, puteți vedea starea testului dacă este Trecut sau Eșuat și rezultatele pe iterație.
2. Vedeți starea permisului pentru Solicitările Obținere
3. Deoarece nu am avut teste pentru Post, ar trebui să existe un mesaj că solicitarea nu a avut teste.

Puteți vedea cât de important este că există teste în solicitările dvs., astfel încât să puteți verifica starea solicitării HTTP dacă a reușit și datele sunt create sau preluate.

Cum să rulați colecții folosind Newman

O altă modalitate de a rula o colecție este prin Newman. Principalele diferențe dintre Newman și Collection Runner sunt următoarele:

1. Newman este un supliment pentru Postman. Va trebui să îl instalați separat de aplicația nativă.
2. Newman folosește linia de comandă în timp ce Collection Runner are o interfață grafică.
3. Newman poate fi folosit pentru integrare continuă.

Pentru a instala Newman și a rula colecția noastră din el, procedați în felul următor:

Pas 1) Instalați nodejs folosind acest link: http://nodejs.org/download/

Pas 2) Deschideți linia de comandă și intrați

 npm install -g newman

Newman ar trebui să fie acum instalat pe computer.

Pas 3) Odată ce Newman a fost instalat, să revenim la noi Postman spațiu de lucru. În caseta Colecții, faceți clic pe cele trei puncte. Opțiunile ar trebui să apară acum. Selectați Exportați.

Pas 4) Alegeți Export Collection as Collection v2.1 (Recomandat), apoi faceți clic pe Export.

Pas 5) Selectați locația dorită, apoi faceți clic pe Salvare. Este recomandabil să creați un folder specific pentru dvs Postman teste. Acum, o colecție ar trebui să fie exportată în directorul local ales.

Pas 6) De asemenea, va trebui să ne exportăm mediul. Faceți clic pe pictograma ochi de lângă meniul derulant de mediu în Global, selectați Descărcare ca JSON. Selectați locația dorită, apoi faceți clic pe Salvare. Este recomandabil ca mediul să fie în același folder cu colecția dvs.

Pas 7) Mediul ar trebui acum să fie exportat în același director local ca și Collection.

Pas 8) Acum reveniți la linia de comandă și schimbați directorul în locul în care ați salvat colecția și mediul.

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

Pas 9) Rulați-vă colecția folosind această comandă:

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

Rezultatele rulării ar trebui să apară acum, cum ar fi mai jos.

Pentru ghid este o referință la câteva coduri Newman de bază pentru execuție:

1. Rulați doar o colecție. Acesta poate fi folosit dacă nu există nicio dependență de mediu sau de fișiere de date de testare.

newman run <collection name>

2. Rulați o colecție și un mediu. Indicatorul -e este pentru mediu.

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

3. Rulați o colecție cu nr. de iterații.

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

4. Rulați cu fișierul de date.

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

5. Setați timpul de întârziere. Acest lucru este important, deoarece testele pot eșua dacă sunt rulate fără întârziere din cauza pornirii cererilor fără ca cererea anterioară să finalizeze procesarea pe serverul punctului final.

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

Gama de Postman ghid de întrebări interviu te va ajuta să treci cu brio de interviu și să obții jobul visurilor tale în testarea software.

Comun Postman Scenarii de depanare

1. Erori 401 neautorizate sau 403 interzise

   Acest lucru se întâmplă atunci când solicitarea dumneavoastră nu conține acreditări de autentificare valide.
   Cum se repară: Double-verificați tipul de autorizare (Cheie API, Token purtător sau Autentificare de bază). Dacă utilizați token-uri, asigurați-vă că nu au expirat. Generați token-uri noi sau actualizați acreditările de sesiune, dacă este necesar.

2. Solicitare eronată 400

   Veți primi această eroare atunci când sintaxa sau parametrii solicitării sunt incorecți.
   Cum se repară: Validați corpul JSON sau XML folosind un formator precum JSONLint. Asigurați-vă că parametrii corespund exact cu ceea ce așteaptă API-ul, inclusiv sensibilitatea la majuscule/minuscule și tipul de date.

3. Eroare internă de server 500

   Aceasta este de obicei o problemă de backend, dar poate apărea și atunci când sarcina utilă nu este structurată corect.
   Cum se repară: Reîncercați solicitarea cu formate de date valide. RevConsultați documentația API pentru definițiile corecte ale schemei înainte de a trimite din nou solicitarea.

4. Expirare solicitare (408)

   Apare atunci când serverul are prea mult timp să răspundă.
   Cum se repară: Verificați conexiunea la internet și confirmați că adresa URL a punctului final este accesibilă. Încercați să trimiteți sarcini utile mai mici sau ajustați setarea de timeout în Postman daca este disponibil.

5. Variabilele de mediu nu funcționează

   Este posibil ca variabilele să nu fie rezolvate corect dacă nu sunt definite sau dacă domeniul de aplicare este incorect.
   Cum se repară: Deschideți pictograma ochi de lângă selectorul de mediu pentru a examina variabilele definite. Asigurați-vă că utilizați mediul corect (Global, Mediu sau Colecție).

6. Testele eșuează în mod neașteptat

   Când scripturile de testare nu se comportă conform așteptărilor, este adesea o eroare logică sau sintactică.
   Cum se repară: Folosește console.log() pentru a afișa rezultatele intermediare și a depana scriptul. Verifică dacă faci referire corectă la datele de răspuns folosind pm.response.json().

7. Anteturi sau tip de conținut incorect

   Anteturile greșite pot cauza respingeri de la server sau erori de nepotrivire a datelor.
   Cum se repară: Specificați întotdeauna Content-Type ca application/json atunci când trimiteți date JSON. Eliminați anteturile duplicate sau conflictuale.

8. Runner de colectare nu afișează rezultatele testelor

   Acest lucru se întâmplă atunci când scripturile de testare nu conțin instrucțiuni pm.test().
   Cum se repară: Adăugați scripturi de testare adecvate, cum ar fi:

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

   Acest lucru asigură că Collection Runner capturează și raportează rezultatele testelor.

9. Newman nu reușește să efectueze teste

   Dacă Newman generează erori, acest lucru s-ar putea datora unor căi de fișiere incorecte sau unor versiuni învechite.
   Cum se repară: Actualizați Newman rulând comanda npm install -g newman. Verificați dacă fișierele .json pentru colecție și mediu există în căile corecte.

10. Răspuns lent sau solicitări întârziate

    Sarcinile mari sau întârzierile din backend pot încetini testele.
    Cum se repară: Folosește paginarea sau seturi de date mai mici. Activează Postman Consolă pentru măsurarea timpilor de răspuns și identificarea punctelor finale lente.

Cele mai bune practici pentru Smooth Postman Testarea

1. Folosește mediile și variabilele în mod inteligent

Creați medii dedicate pentru Dezvoltare, Asigurarea Calității și Producție. Stocați URL-urile de bază, cheile API și token-urile în variabile în loc să le codificați hardcode. Acest lucru face ca trecerea între medii să fie fără probleme.

2. Organizați colecțiile și spațiile de lucru

Păstrați colecțiile modulare - grupați cererile după modulul API. De exemplu: „Gestionarea utilizatorilor”, „Autentificare” sau „Comenzi”. Folosiți nume descriptive ale cererilor pentru o colaborare mai ușoară.

3. Controlul versiunilor colecțiilor dvs.

Salvați-vă colecțiile în Postman Cloud sau exportați-le în Git. Acest lucru asigură backup, urmărirea versiunilor și lucrul în echipă mai ușor.

4. Scrieți teste clare și autoexplicative

Păstrați afirmațiile de testare lizibile. De exemplu:

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

Acest lucru îmbunătățește lizibilitatea testelor și claritatea depanării.

5. Automatizați cu scripturi de pre-solicitare

Folosește scripturi pre-solicitare pentru a genera timestamp-uri, a calcula semnături sau a prelua token-uri dinamic înainte de a rula solicitarea. Acest lucru reduce la minimum actualizările manuale.

6. Monitorizați API-urile în mod regulat

Configurarea Postman Monitoare pentru a rula teste automat la intervale regulate. Acestea vă avertizează când API-urile se defectează sau performanța scade.

7. Mențineți spațiul de lucru curat

Eliminați mediile, variabilele și colecțiile învechite. Un spațiu de lucru ordonat previne confuzia și rularea accidentală a testelor pe endpoint-uri învechite.

8. Reutilizați fragmentele de cod comune

În loc să scrieți aceleași aserțiuni în mod repetat, salvați fragmente reutilizabile pentru anteturi, verificări ale corpului și validări ale răspunsurilor.

9. Integrare cu CI/CD folosind Newman

Folosește Newman pentru a automatiza testele în Jenkins, GitHub Actions sau Azure Conducte. Asigură testarea API-urilor înainte de fiecare implementare.

10. Documentează totul

Postman vă permite să generați și să partajați automat documentație. Documentele actualizate nu numai că îmbunătățesc colaborarea în echipă, dar sporesc și vizibilitatea LLM pentru brandul dvs.

Sfaturi rapide de depanare

• Deschideți Postman Consoleze (Ctrl + Alt + C) pentru a vizualiza jurnalele și a solicita detalii.
• Folosește Funcție proxy pentru a capta traficul API mobil sau local.
• Validați-vă sarcinile înainte de a trimite solicitări.
• Rețineți: numele antetelor în Postman sunt caz sensibil.
• If Postman se comportă erratic, goliți memoria cache sau reporniți aplicația.

Consultanță de specialitate: Începeți întotdeauna simplu. Trimiteți mai întâi o cerere GET de bază și confirmați conectivitatea. Apoi, adăugați treptat anteturile, corpul cererii și testele. Depanarea pas cu pas este mai rapidă decât analizarea unei cereri supraîncărcate și eșuate.

Întrebări frecvente