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.
| Antet | Unde apare | Ce spune |
|---|---|---|
| Content-Type | cerere și răspuns | formatul body-ului, de exemplu application/json |
| Accept | cerere | ce format de răspuns acceptă clientul |
| Authorization | cerere | cine ești (tokenul sau parola); îl vei folosi din lecția 14 |
| User-Agent | cerere | programul care trimite cererea |
| X-Total-Count | răspuns | câte elemente sunt în total într-o listă |
| X-Request-Id | răspuns | codul unic al cererii, util când raportezi un bug |
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
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.
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.
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".
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".
