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

Antetele (headers) cererii și ale răspunsului

Pe lângă metodă, URL și body, orice cerere și orice răspuns poartă o serie de antete: perechi Nume: valoare cu informații despre mesaj. În această lecție afli ce antete sunt importante, ce antete adaugă Postman singur și cum trimiți un antet al tău.

Eticheta de pe colet

Când trimiți un colet, pe cutie lipești o etichetă: cine trimite, ce conține, dacă e fragil. Curierul citește eticheta fără să deschidă coletul. Antetele HTTP (în engleză headers) sunt exact această etichetă: informații despre cerere sau despre răspuns, separate de conținutul propriu-zis (body).

Un antet are forma Nume: valoare. Numele nu ține cont de litere mari sau mici: Content-Type și content-type sunt același antet.

AntetUnde apareCe spune
Content-Typecerere și răspunsformatul body-ului, de exemplu application/json
Acceptcererece format de răspuns acceptă clientul
Authorizationcererecine ești (tokenul sau parola); îl vei folosi din lecția 14
User-Agentcerereprogramul care trimite cererea
X-Total-Countrăspunscâte elemente sunt în total într-o listă
X-Request-Idrăspunscodul unic al cererii, util când raportezi un bug
Bine de știut

Antetele care încep cu X- sunt antete „personalizate”, inventate de echipa care a făcut API-ul. Nu fac parte din standard, dar sunt foarte des întâlnite.

Antetele pe care le pune Postman singur

Deschide tabul Headers al unei cereri noi. Tabelul pare gol, dar Postman adaugă automat la fiecare cerere câteva antete. După Send, apasă pe linkul Arată headerele automate din tabul Headers ca să le vezi (în Postman-ul instalat pe calculator, butonul se numește „hidden”). Iată tot ce a plecat într-o cerere către echo.test/headers, cu un antet adăugat de noi (X-Curs):

GET https://echo.test/headers
X-Curs: API Testing
X-Curs: API Testing
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
  • User-Agent: PostmanRuntime/... spune serverului că cererea vine din Postman;
  • Postman-Token este un cod unic, diferit la fiecare cerere;
  • Host este numele serverului, luat din URL;
  • Accept: */* înseamnă „accept orice format”.

La cererile cu body, Postman adaugă și Content-Type și Content-Length (mărimea body-ului). Vei vedea asta în lecția 7.

Trimite un antet al tău

1
Deschide tabul Headers de sub URL.
2
Pe un rând gol scrie la Key X-Curs și la Value API Testing.
3
Lasă bifa din stânga rândului activă (debifat = antetul nu se trimite).
4
Apasă Send.

Serverul echo.test/headers îți întoarce toate antetele primite, cu numele scrise cu litere mici:

200 OK
{
  "headers": {
    "x-curs": "API Testing",
    "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"
  }
}

Primul antet din listă este al tău: "x-curs": "API Testing". Așa confirmi că antetul a plecat corect.

Atenție

Nu scrie spații în numele antetului și nu pune : în câmpul Key. Postman adaugă singur separatorul dintre nume și valoare.

Antetele răspunsului

Serverul își trimite și el antetele. În panoul de răspuns, deschide tabul Headers. La lista de produse a magazinului vei găsi:

GET https://api.magazin.test/products?limit=1
200 OK
Content-Type: application/json; charset=utf-8
X-Request-Id: req_5xqjd3
X-Total-Count: 30
  • Content-Type confirmă că body-ul este JSON;
  • X-Request-Id este codul cererii tale: dacă găsești un bug, îl treci în raport și programatorul găsește imediat cererea în jurnalele serverului;
  • X-Total-Count: 30 spune câte produse are magazinul, chiar dacă ai cerut doar unul.

Testerii verifică și antetele, nu doar body-ul. Un bug real și des întâlnit: API-ul trimite JSON, dar spune în Content-Type că trimite HTML. Unele aplicații nu mai pot citi răspunsul și afișează un ecran gol.

Greșeli frecvente

  • Pui antetul în Params. Params adaugă parametri în URL; antetele merg în tabul Headers.
  • Scrii valoarea cu ghilimele. Scrie API Testing, nu "API Testing": ghilimelele ar deveni parte din valoare.
  • Uiți bifa debifată. Un antet debifat rămâne în tabel, dar nu pleacă la server.
  • Cauți antetul în Body. Antetele răspunsului sunt în tabul Headers al panoului de răspuns, nu în body.

Din aplicațiile reale

  • Aplicațiile multilingve trimit antetul Accept-Language: ro ca serverul să răspundă cu textele în română.
  • Echipele de suport cer X-Request-Id din raportul de bug ca să găsească exact cererea care a dat eroare.
Exercițiul tău

Trimite serverului de ecou un antet personalizat și verifică în răspuns că a ajuns.

  • Pregătește GET https://echo.test/headers.
  • În tabul Headers adaugă antetul X-Curs cu valoarea API Testing.
  • Trimite cererea și găsește în body "x-curs": "API Testing".
Antetul se scrie în tabul Headers de sub URL: Key = X-Curs, Value = API Testing.

Soluția exercițiului

1. Metoda GET, URL https://echo.test/headers.
2. Tabul Headers: Key X-Curs, Value API Testing (cu bifa activă).
3. Send: în body, la headers, apare "x-curs": "API Testing".
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 5 · Antetele (headers) cererii și ale răspunsului
Progres 0% 0 din 12
Lecția curentă 5 / 10 Http