...
← Blog Testare (qa)

Postman tutorial în română: primul request și primul test de API

Postman tutorial: sigla Postman lângă un editor de cod și o bifă verde de test trecut

Acest Postman tutorial te duce de la zero la primul test de API în aproximativ o oră. Postman este o aplicație în care trimiți cereri către un API, vezi răspunsul și scrii teste care îl verifică automat. Pornești cu un GET către un API public gratuit, treci la POST cu JSON și termini cu teste rulate dintr-o colecție.

Toate răspunsurile din articol sunt reale: le-am obținut cu curl din API-ul de test JSONPlaceholder, așa că le poți compara cu ce vezi tu în Postman. Dacă vrei să exersezi direct în browser, cu exerciții verificate automat, ai la noi un curs Postman de API testing cu primele 10 lecții gratuite.

Ce este Postman și la ce folosește

Postman este un client de API: un program care trimite cereri HTTP către un server și îți arată tot ce primește înapoi, adică codul de status, antetele și corpul răspunsului. Un API este felul în care două programe vorbesc între ele. Când aplicația unui magazin online din Cluj îți afișează comenzile, telefonul cere datele de la un API, iar serverul le trimite, de obicei, în format JSON.

Developerii folosesc Postman ca să încerce un endpoint înainte să existe interfața. Testerii îl folosesc pentru API testing, adică verificarea directă a logicii din spatele ecranelor: dacă datele sunt corecte, dacă erorile sunt tratate și dacă accesul e protejat. Dacă vrei să înțelegi mai întâi regulile după care sunt construite majoritatea API-urilor, citește ce este un REST API, explicat cu exemple.

Cum instalezi Postman (sau folosești varianta web)

Ai două variante: aplicația desktop, descărcată de pe pagina oficială Postman, sau aplicația web, deschisă direct în browser. Pentru început, recomand aplicația desktop. Are toate funcțiile și, în plus, are un client ușor pe care îl poți folosi fără cont, ca să trimiți cereri imediat.

Varianta web cere cont. Ca să ocolească limitele browserului (CORS), Postman recomandă să instalezi și Postman Desktop Agent, un program mic care trimite cererile în locul paginii. Pentru un API public, cum e cel din acest tutorial, merge și fără el, dar dacă vezi erori ciudate de rețea în browser, agentul e primul lucru de verificat.

Postman tutorial pas cu pas: primul GET către un API gratuit

Primul request este un GET, metoda prin care citești date. Vom folosi JSONPlaceholder, un API gratuit făcut pentru exerciții, care nu cere cheie sau cont. L-am verificat azi cu curl și răspunde fără autentificare.

  1. În Postman, apasă New și alege HTTP (sau deschide un tab nou cu +).
  2. Lasă metoda pe GET și scrie în bara de adresă: https://jsonplaceholder.typicode.com/posts/1.
  3. Apasă Send.
  4. Uită-te în partea de jos: în dreapta sus vezi statusul (200 OK), timpul și mărimea răspunsului, iar în tab-ul Body vezi JSON-ul.

Același request din terminal, cu curl, ca să ai un punct de comparație:

curl -s https://jsonplaceholder.typicode.com/posts/1

Răspunsul primit:

{
  "userId": 1,
  "id": 1,
  "title": "sunt aut facere repellat provident occaecati excepturi optio reprehenderit",
  "body": "quia et suscipit\nsuscipit recusandae consequuntur expedita et cum\nreprehenderit molestiae ut ut quas totam\nnostrum rerum est autem sunt rem eveniet architecto"
}

Important e să citești structura: un obiect JSON cu patru câmpuri, dintre care id și userId sunt numere, iar title și body sunt texte. Exact pe aceste câmpuri vei scrie mai jos primele teste.

Codurile de status pe care trebuie să le recunoști

Codul de status este numărul de trei cifre prin care serverul îți spune pe scurt cum a mers cererea. Prima cifră contează cel mai mult: 2xx înseamnă succes, 4xx înseamnă că ai greșit ceva în cerere, iar 5xx înseamnă că s-a stricat ceva pe server. Lista completă e pe MDN, la HTTP response status codes.

CodCe înseamnăCând l-am primit în acest tutorial
200 OKCererea a reușitGET /posts/1
201 CreatedS-a creat o resursă nouăPOST /posts cu JSON
404 Not FoundResursa nu existăGET /posts/9999 (corpul răspunsului a fost {})
500 Internal Server ErrorServerul n-a putut procesa cerereaPOST cu JSON stricat (virgulă în plus)

Ultimul rând e o lecție bună pentru tester: un JSON invalid trimis de client ar trebui să primească un 400 Bad Request, nu un 500. Pe un API real, asta e un bug pe care îl raportezi.

Parametri și antete: cum filtrezi și ce trimiți în plus

Parametrii de query sunt perechile cheie=valoare de după semnul întrebării din URL și servesc la filtrare. În Postman îi completezi în tab-ul Params, iar aplicația îi adaugă singură în adresă. Încearcă https://jsonplaceholder.typicode.com/posts?userId=1: am primit o listă cu 10 postări, toate ale utilizatorului 1. Cu /comments?postId=1 primești cele 5 comentarii ale primei postări.

Antetele (headers) sunt informații despre cerere sau răspuns, trimise separat de corp. Cel pe care îl vei atinge cel mai des e Content-Type, care spune în ce format sunt datele. În răspunsul de mai sus, serverul a trimis content-type: application/json; charset=utf-8. Vezi antetele răspunsului în tab-ul Headers de jos, iar pe cele ale cererii în tab-ul Headers de sus. Dacă vrei să știi ce se întâmplă de fapt în spatele acestor cereri, intrarea despre HTTP din dicționar explică pe scurt protocolul.

POST cu body JSON: creezi o resursă

POST este metoda prin care trimiți date noi către server, iar datele stau în body-ul cererii. Schimbă metoda în POST, URL-ul în https://jsonplaceholder.typicode.com/posts, apoi intră în Body, alege raw și din lista din dreapta alege JSON. Scrie:

{
  "title": "Comanda nr. 1024",
  "body": "Livrare la Cluj",
  "userId": 1
}

Echivalentul în curl și ce am primit înapoi, cu statusul 201:

curl -s -X POST https://jsonplaceholder.typicode.com/posts \
  -H "Content-Type: application/json" \
  -d '{"title":"Comanda nr. 1024","body":"Livrare la Cluj","userId":1}'
{
  "title": "Comanda nr. 1024",
  "body": "Livrare la Cluj",
  "userId": 1,
  "id": 101
}

Serverul a întors datele trimise și un id nou. JSONPlaceholder doar simulează salvarea, deci dacă ceri apoi /posts/101, vei primi 404. Pe un API real, asta ar fi un bug serios.

Un detaliu care îi încurcă pe mulți: când am trimis aceleași date ca text simplu, fără Content-Type: application/json, răspunsul a fost doar {"id": 101}. Serverul n-a înțeles corpul și l-a ignorat, deși statusul a fost tot 201. De aceea, în Postman alegi mereu JSON din lista de lângă raw, iar aplicația pune antetul corect pentru tine.

Environments și variabile: scapi de URL-uri copiate peste tot

O variabilă în Postman este un nume care ține o valoare și pe care o folosești în cereri scriind numele între acolade duble, de exemplu {{baseUrl}}. Un environment este un set de variabile pentru un anumit mediu, cum ar fi test sau producție, și poate fi activ doar unul odată.

  1. Intră la Environments și creează unul nou, numit „JSONPlaceholder”.
  2. Adaugă variabila baseUrl cu valoarea https://jsonplaceholder.typicode.com și salvează.
  3. Selectează environment-ul din lista din dreapta sus.
  4. Schimbă URL-urile cererilor în {{baseUrl}}/posts/1 și {{baseUrl}}/posts.

Dacă mâine API-ul se mută pe alt server, schimbi o singură valoare, nu 30 de cereri. Postman are mai multe niveluri de variabile (globale, de colecție, de environment, de date și locale), iar când același nume există în două locuri, câștigă cel mai restrâns. Detaliile sunt în documentația despre variabile.

Primele teste în Postman: pm.test și pm.expect

Un test în Postman este o bucată scurtă de JavaScript care rulează după ce vine răspunsul și verifică dacă e cel așteptat. În versiunile actuale, testele se scriu în tab-ul Scripts, la Post-response (în versiunile vechi, tab-ul se numea Tests). Pune acest cod pe cererea GET {{baseUrl}}/posts/1:

pm.test("Statusul este 200", function () {
    pm.response.to.have.status(200);
});

pm.test("Răspunsul este JSON", function () {
    pm.expect(pm.response.headers.get("Content-Type")).to.include("application/json");
});

pm.test("Postarea are id 1 și un titlu", function () {
    const post = pm.response.json();
    pm.expect(post.id).to.eql(1);
    pm.expect(post.userId).to.eql(1);
    pm.expect(post.title).to.be.a("string").and.not.be.empty;
});

pm.test("Răspunsul vine în mai puțin de 1 secundă", function () {
    pm.expect(pm.response.responseTime).to.be.below(1000);
});

Apasă Send și deschide tab-ul Test Results din partea de jos. Ar trebui să vezi patru teste trecute. Ca să verifici că testele chiar prind ceva, schimbă URL-ul în {{baseUrl}}/posts/9999: primul test pică, pentru că primești 404, iar al treilea pică pentru că obiectul e gol.

Ce face fiecare bucată: pm.test primește un nume și o funcție, pm.response.json() transformă corpul răspunsului într-un obiect JavaScript, iar pm.expect face o verificare în stilul bibliotecii Chai (to.eql, to.include, to.be.below). Sintaxa e cea din exemplele oficiale de teste Postman, unde găsești și verificări pentru antete, cookie-uri și scheme JSON. Pentru POST, scrie un test care verifică statusul 201 și că pm.response.json().title este „Comanda nr. 1024”.

Colecții și Collection Runner: rulezi totul dintr-un click

O colecție este un dosar în care salvezi cereri înrudite, împreună cu testele și variabilele lor. Apasă Save pe fiecare cerere și pune-le într-o colecție nouă, „Blog API”, eventual cu foldere separate pentru postări și comentarii.

Collection Runner rulează toate cererile din colecție, în ordine, și îți arată un raport cu testele trecute și picate. Deschide colecția, apasă Run, alege environment-ul și pornește rularea. Așa arată regresia pe un API: după fiecare modificare a aplicației, rulezi aceeași colecție și vezi imediat ce s-a stricat. Pasul următor, pe care îl faci mai târziu, e rularea colecției automat în CI, cu Newman sau Postman CLI.

Greșeli frecvente la început în Postman

Aproape toate problemele de la primele ore cu Postman vin din câteva greșeli mici, ușor de reparat odată ce le știi.

  • Body trimis ca Text, nu ca JSON. Serverul ignoră datele, cum ai văzut mai sus. Alege raw și apoi JSON.
  • JSON cu virgulă după ultimul câmp sau cu ghilimele simple. JSON acceptă doar ghilimele duble și nicio virgulă la final.
  • Environment-ul nu e selectat, iar {{baseUrl}} apare cu roșu și cererea pleacă spre o adresă invalidă.
  • Spații sau un slash în plus în URL: /posts/1/ și /posts/1 nu sunt mereu același lucru pentru server.
  • Teste care verifică doar statusul. Un 200 cu date greșite e tot un bug, așa că verifică și câmpurile din răspuns.
  • Cereri nesalvate în colecție. Tab-urile deschise se pierd ușor, iar o cerere nesalvată nu poate fi rulată din Collection Runner.

Exercițiu pentru tine

Construiește o colecție „Comentarii” cu două cereri: un GET pe {{baseUrl}}/comments?postId=1 care testează că primești exact 5 elemente și că fiecare are un câmp email, și un POST pe {{baseUrl}}/comments care testează statusul 201. Indiciu pentru primul: pm.expect(pm.response.json()).to.have.lengthOf(5). Rulează apoi colecția din Collection Runner și verifică raportul.

Întrebări frecvente

Postman este gratuit?

Da, pentru învățat și pentru lucru individual ai un plan gratuit, suficient pentru tot ce e în acest tutorial. Planurile plătite adaugă funcții pentru echipe. Limitele exacte se schimbă, așa că verifică-le pe site-ul Postman.

Trebuie să știu programare ca să folosesc Postman?

Nu ca să trimiți cereri. Pentru teste ai nevoie de puțin JavaScript, dar tiparele sunt repetitive și le înveți din exemple, cum sunt cele de mai sus. Mulți testeri manuali încep cu API testing înainte să învețe un limbaj.

Ce este API testing?

API testing înseamnă să verifici un API direct, prin cereri, fără să treci prin interfața aplicației. Verifici codurile de status, datele din răspuns, mesajele de eroare, autentificarea și timpul de răspuns. Postman este unealta cea mai la îndemână pentru a începe.

Care e diferența dintre Postman și curl?

Fac același lucru la bază: trimit cereri HTTP. Curl e o comandă în terminal, bună pentru verificări rapide și scripturi. Postman adaugă interfață, colecții, variabile, teste și rapoarte, ceea ce îl face potrivit pentru testare organizată.

Unde exersez Postman gratuit?

Pe API-uri publice de test, cum este JSONPlaceholder, care nu cer cheie. Dacă vrei exerciții cu verificare automată și un magazin demo cu bug-uri de găsit, primele 10 lecții din cursul nostru sunt gratuite și rulează în browser.

Primul pas: trimite azi un GET și scrie un test

Deschide Postman, trimite GET-ul pe /posts/1 și adaugă primul pm.test. Durează zece minute și ai deja ce pune în portofoliu ca prim exercițiu de API testing. Dacă vrei să mergi mai departe cu autentificare, testare negativă, date din CSV și rularea în CI, le înveți pas cu pas în cursul de API testing cu Postman: 70 de lecții, toate în browser, cu un Postman simulat și exerciții verificate automat. Primele 10 lecții sunt gratuite, fără card.

Postman face parte din traseul de QA Engineer, alături de testarea manuală și automatizare. Dacă abia te gândești la QA, vezi întâi cum devii QA tester pornind de la zero.

Logo Curs API Testing cu Postman Interactiv · 10 lecții gratuite

Curs API Testing cu Postman

Testarea API-urilor cu Postman pentru începători: HTTP, JSON, teste și colecții

Începe gratuit

Citește și

Primul tău program e la 5 minute distanță.

Creează-ți contul gratuit și începe primele 15 lecții. Fără card, fără instalări.

Începe gratuit