Recapitulare: primii pași cu API-uri
Ai terminat primul modul. Știi ce este un API, cum arată o cerere și un răspuns HTTP, ce fac metodele, cum desfaci un URL, ce sunt antetele, codurile de status și JSON-ul. În această lecție legi totul într-un mini-proiect: explorezi singur magazinul demo, ca un tester în prima zi pe un proiect nou.
Ce ai învățat până acum
| Lecția | Ideea principală |
|---|---|
| 1. Ce este un API | două programe vorbesc prin cereri și răspunsuri; testarea API găsește bug-urile devreme |
| 2. Cererea și răspunsul | cererea = metodă, URL, antete, body; răspunsul = status, antete, body, timp, mărime |
| 3. Metodele | GET citește, POST creează, PUT înlocuiește, PATCH modifică, DELETE șterge (CRUD) |
| 4. URL-ul | protocol, host, cale, parametri de query (?cheie=valoare&...), tabul Params |
| 5. Antetele | perechi Nume: valoare; Postman pune unele automat; X-Total-Count, X-Request-Id |
| 6. Codurile de status | 2xx succes, 3xx redirecționare, 4xx greșeala clientului, 5xx greșeala serverului |
| 7. JSON | obiecte, liste, text, număr, boolean, null; ghilimele duble, fără virgulă la final |
| 8. REST | resurse (substantive) + metode (verbe); colecție /products și element /products/7; documentația OpenAPI |
| 9. Istoricul și consola | reiei cereri din History, verifici în consolă ce a plecat, partajezi cererea ca cURL |
Lista de verificare a unui răspuns
Indiferent de endpoint, la fiecare răspuns parcurgi aceeași listă. În modulul următor o vei transforma în teste automate, dar mai întâi trebuie să o faci „de mână”:
Un răspuns poate fi „verde” (200) și totuși greșit: filtrul nu a fost aplicat, lipsește un câmp, prețul e text. Statusul e doar primul pas al verificării.
Exemplu: telefoanele din magazin
Aplicăm lista pe o cerere din mini-proiect. Filtrezi după categorie:
GET https://api.magazin.test/products?category=telefoane
200 OK
X-Total-Count: 3
{
"data": [
{
"id": 4,
"name": "Telefon Nova 5G",
"sku": "TELEFON-NOVA-004",
"price": 1899,
"currency": "RON",
"category": "telefoane",
"stock": 30,
"rating": 4.4,
"active": true,
"createdAt": "2026-01-14T10:00:00.000Z"
},
{
"id": 5,
"name": "Telefon Mini 6",
"sku": "TELEFON-MINI-005",
"price": 1299,
"currency": "RON",
"category": "telefoane",
"stock": 0,
"rating": 4.1,
"active": true,
"createdAt": "2026-01-17T10:00:00.000Z"
},
{
"id": 6,
"name": "Telefon Pro Max 12",
"sku": "TELEFON-PRO--006",
"price": 5499,
"currency": "RON",
"category": "telefoane",
"stock": 7,
"rating": 4.7,
"active": true,
"createdAt": "2026-01-20T10:00:00.000Z"
}
],
"page": 1,
"limit": 10,
"total": 3,
"totalPages": 1
}- statusul este 200 și X-Total-Count spune 3;
- în data sunt exact 3 produse, toate cu "category": "telefoane", deci filtrul funcționează;
- price și stock sunt numere; „Telefon Mini 6” are stoc 0, o informație bună pentru un caz de test la coș.
Mini-proiect: explorează magazinul
Imaginează-ți că ai fost angajat azi ca tester pe magazinul demo. Înainte să scrii teste, îl explorezi: ce categorii are, cum se filtrează, cum arată o eroare și cum trimiți date. Exercițiul din dreapta are patru cereri și un quiz scurt cu trei întrebări.
Nu te grăbi. Pentru fiecare răspuns, citește statusul, antetele și body-ul înainte să treci mai departe. Asta e diferența dintre „a trimis cereri” și „a testat”.
Ce urmează
În modulul următor treci de la explorare la lucrul serios: trimiți date în toate formatele de body, faci operații complete pe coșul de cumpărături, folosești variabile de cale și te autentifici cu cheie API, Basic Auth și token. Apoi scrii primele teste automate.
- Coșul de cumpărături: CRUD complet cu POST, PATCH, GET și DELETE;
- Autentificarea: API key, Basic, login cu token Bearer, JWT;
- Variabilele și colecțiile: lucrezi ca într-o echipă reală, fără să rescrii adresele.
Explorează magazinul demo ca un tester nou pe proiect: patru cereri și trei întrebări de verificare.
- Trimite GET https://api.magazin.test/categories.
- Trimite GET https://api.magazin.test/products cu parametrul category=telefoane.
- Trimite GET https://api.magazin.test/products/9999 și verifică statusul 404.
- Trimite POST https://echo.test/post cu un body raw JSON, de exemplu {"tester": "eu"}.
- Răspunde la cele trei întrebări din secțiunea Întrebări.
Soluția exercițiului
1. GET https://api.magazin.test/categories → 200, cele 5 categorii.
2. GET https://api.magazin.test/products?category=telefoane → 200, 3 telefoane.
3. GET https://api.magazin.test/products/9999 → 404 Not Found.
4. POST https://echo.test/post, Body raw JSON {"tester": "eu"} → 200, în răspuns json.tester = "eu".
5. Quiz: 201 Created; GET; resursa cerută nu există. 