...
← Curs API Testing cu Postman: toate lecțiile
Lecția 2 · HTTP

Cererea și răspunsul HTTP

Orice discuție cu un API are două jumătăți: cererea pe care o trimiți și răspunsul pe care îl primești. În această lecție desfaci pe bucăți amândouă jumătățile și înveți să citești panoul de răspuns din Postman ca un tester: statusul, antetele, body-ul, timpul și mărimea.

HTTP, limba comună a aplicațiilor

Aplicațiile web și mobile vorbesc cu serverele printr-un set de reguli numit HTTP (HyperText Transfer Protocol). Gândește-te la el ca la formularul standard dintr-o instituție: oricine îl completează la fel, așa că oricine îl poate citi. Browserul tău folosește HTTP de fiecare dată când deschizi o pagină, iar aplicațiile folosesc HTTP când cer date de la API.

Regula de bază este simplă: clientul (Postman, browserul, aplicația de pe telefon) trimite o cerere, iar serverul trimite înapoi exact un răspuns. Serverul nu vorbește niciodată primul.

Important

O cerere fără răspuns nu există în HTTP: primești fie un răspuns (chiar și unul cu eroare, ca 404), fie o eroare de rețea (serverul nu a putut fi găsit sau nu a răspuns la timp). Ca tester, deosebești mereu aceste două situații.

Anatomia unei cereri

O cerere HTTP are patru părți. În Postman fiecare are locul ei pe ecran:

ParteaCe înseamnăUnde o vezi în Postman
metodace vrei să faci (GET = dă-mi, POST = creează...)lista din stânga câmpului URL
URL-uladresa resursei de pe servercâmpul URL
antetele (headers)informații suplimentare despre cerere, ca eticheta de pe un colettabul Headers
body-ul (corpul)datele trimise, de exemplu un produs nou; GET nu are bodytabul Body

Iată o cerere simplă către serverul de ecou echo.test. Acest server este făcut special pentru învățat: îți trimite înapoi exact ce a primit, așa că vezi cu ochii tăi cum arată cererea ajunsă la server.

GET https://echo.test/get?curs=postman
200 OK
{
  "args": {
    "curs": "postman"
  },
  "headers": {
    "user-agent": "PostmanRuntime/7.43.0",
    "accept": "*/*",
    "cache-control": "no-cache",
    "postman-token": "937b2e84-d09a-42a1-837b-2e84d09a92a1",
    "host": "echo.test",
    "accept-encoding": "gzip, deflate, br",
    "connection": "keep-alive"
  },
  "url": "https://echo.test/get?curs=postman"
}

Partea ?curs=postman din URL a ajuns la server ca args, iar în headers vezi antetele pe care Postman le-a adăugat singur (de exemplu user-agent, care spune cine trimite cererea). Despre URL și antete vorbim pe larg în lecțiile 4 și 5.

Anatomia unui răspuns

Răspunsul are și el câteva părți fixe. Toate apar în panoul de jos după ce apeși Send:

  • statusul: un număr de trei cifre și un text scurt, de exemplu 200 OK; spune dacă cererea a reușit (lecția 6 e dedicată codurilor);
  • antetele răspunsului: informații de la server, de exemplu Content-Type, adică formatul body-ului;
  • body-ul: datele propriu-zise, de obicei în format JSON;
  • timpul: câte milisecunde (ms) a durat până a venit răspunsul;
  • mărimea: câți bytes (B) are răspunsul, cu tot cu antete.
GET https://api.magazin.test/categories
200 OK
Content-Type: application/json; charset=utf-8
X-Request-Id: req_a80dgf
[
  {
    "id": "laptopuri",
    "name": "Laptopuri",
    "products": 3
  },
  {
    "id": "telefoane",
    "name": "Telefoane",
    "products": 3
  },
  {
    "id": "accesorii",
    "name": "Accesorii",
    "products": 13
  },
  {
    "id": "carti",
    "name": "Cărți",
    "products": 5
  },
  {
    "id": "casa",
    "name": "Casă și birou",
    "products": 6
  }
]

Primul rând este statusul. Urmează antetele răspunsului: Content-Type spune că body-ul este JSON scris cu diacritice (charset=utf-8), iar X-Request-Id este un cod unic pe care serverul îl dă fiecărei cereri. Body-ul este o listă cu cele cinci categorii ale magazinului. În Postman, lângă status mai vezi și timpul (57 ms) și mărimea (342 B).

Panoul de răspuns, pas cu pas

1
Apasă Send și uită-te întâi la status, în dreapta sus a panoului de răspuns: culoarea lui se schimbă după familia codului (succes sau eroare).
2
Tabul Body → Pretty arată JSON-ul aranjat frumos, cu indentare și culori. Raw îl arată exact cum a venit de la server, pe un singur rând.
3
Tabul Headers din panoul de răspuns listează antetele trimise de server.
4
Lângă status citește timpul și mărimea. Treci cu mouse-ul peste ele dacă vrei detaliile.
5
Tabul Test Results rămâne gol deocamdată: acolo apar testele automate, pe care le scrii din modulul următor.
Bine de știut

Pretty nu schimbă datele, doar felul în care sunt afișate. Dacă un body pare ciudat în Pretty, uită-te în Raw: acolo vezi exact ce a trimis serverul, cu tot cu eventualele greșeli de format.

Un tester nu se uită doar dacă „a mers”. Pentru fiecare răspuns își pune aceleași întrebări: statusul este cel așteptat? Body-ul are câmpurile promise în documentație? Formatul (Content-Type) este corect? Timpul este rezonabil?

Timpul și mărimea contează

Cererea către /health de pe magazin durează doar câteva zeci de milisecunde:

GET https://api.magazin.test/health
200 OK
{
  "status": "ok",
  "time": "2026-11-03T09:00:00.106Z"
}

Dacă același endpoint ar răspunde brusc în 3 secunde, utilizatorii ar simți aplicația „înțepenită”, chiar dacă statusul e tot 200. De aceea testerii notează timpul de răspuns și, mai târziu în curs, scriu teste care pică automat dacă un răspuns e prea lent.

Ce observiCe poate însemna
timp mult mai mare decât de obiceio problemă de performanță pe server
mărime foarte mareserverul trimite date de care nu e nevoie (de exemplu toate produsele, fără paginare)
body gol la un status 200un bug: serverul spune că a reușit, dar nu trimite nimic

Greșeli frecvente

  • Te uiți doar la body. Un body care arată bine poate veni cu statusul greșit. Citește întâi statusul.
  • Confunzi antetele cererii cu cele ale răspunsului. Tabul Headers de sub URL este al cererii tale; tabul Headers din panoul de jos este al răspunsului.
  • **Uiți de https://.** Fără protocol, adresa poate fi interpretată greșit. Scrie mereu adresa completă.
  • Lași un spațiu la finalul URL-ului. Pare invizibil, dar unele servere îl consideră parte din adresă.

Din aplicațiile reale

  • Aplicația de livrări: când deschizi lista de restaurante, trimite o cerere GET și desenează ecranul din body-ul răspunsului.
  • Plata cu cardul: aplicația trimite o cerere POST cu datele plății, iar statusul răspunsului decide dacă vezi „Plată reușită” sau un mesaj de eroare.
Exercițiul tău

Trimite o cerere la serverul de ecou ca să vezi cum ajunge cererea ta la server, apoi cere categoriile magazinului și citește răspunsul.

  • Trimite GET https://echo.test/get?curs=postman și găsește în body valoarea primită în args.
  • Trimite GET https://api.magazin.test/categories.
  • La a doua cerere, uită-te la status, la tabul Headers al răspunsului, la timp și la mărime.
Scrie fiecare adresă în câmpul URL, cu metoda GET, și apasă Send. Poți deschide un tab nou cu + pentru a doua cerere.

Soluția exercițiului

1. În câmpul URL scrie https://echo.test/get?curs=postman și apasă Send: în body vezi "args": {"curs": "postman"}.
2. Schimbă URL-ul în https://api.magazin.test/categories și apasă Send: primești 200 OK și lista cu cele 5 categorii.
3. Deschide tabul Headers din panoul de răspuns: vezi Content-Type și X-Request-Id.
Excelent! Continuă cu lecția următoare →
PostmanPostman
VerificareSe încarcă...
Mediul de lucru se încarcă. Poți citi lecția între timp.
Parcursul tău Primii pași cu API-uri și Postman Lecția 2 · Cererea și răspunsul HTTP
Progres 0% 0 din 12
Lecția curentă 2 / 10 Http