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.
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:
| Partea | Ce înseamnă | Unde o vezi în Postman |
|---|---|---|
| metoda | ce vrei să faci (GET = dă-mi, POST = creează...) | lista din stânga câmpului URL |
| URL-ul | adresa resursei de pe server | câmpul URL |
| antetele (headers) | informații suplimentare despre cerere, ca eticheta de pe un colet | tabul Headers |
| body-ul (corpul) | datele trimise, de exemplu un produs nou; GET nu are body | tabul 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
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 observi | Ce poate însemna |
|---|---|
| timp mult mai mare decât de obicei | o problemă de performanță pe server |
| mărime foarte mare | serverul trimite date de care nu e nevoie (de exemplu toate produsele, fără paginare) |
| body gol la un status 200 | un 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.
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.
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. 