Metodele HTTP: GET, POST, PUT, PATCH, DELETE
URL-ul spune pe ce lucrezi, iar metoda spune ce faci cu acel lucru. În această lecție înveți cele cinci metode HTTP pe care le vei folosi zilnic, legătura lor cu operațiile CRUD și ce înseamnă, pe scurt, ca o metodă să fie idempotentă.
Verbele unui API
Fiecare cerere HTTP începe cu o metodă, un verb scris cu majuscule. Serverul citește metoda și decide ce operație face. Aceeași adresă poate face lucruri diferite în funcție de metodă: GET /products îți dă lista de produse, iar POST /products adaugă un produs nou.
| Metoda | Ce face | Exemplu în magazin | Are body? |
|---|---|---|---|
| GET | citește date | GET /products/7 = vezi produsul 7 | nu |
| POST | creează ceva nou | POST /cart/items = adaugi un produs în coș | da |
| PUT | înlocuiește complet o resursă | PUT /products/7 = rescrii tot produsul 7 | da |
| PATCH | modifică doar câteva câmpuri | PATCH /cart/items/7 = schimbi doar cantitatea | da |
| DELETE | șterge | DELETE /cart/items/7 = scoți produsul din coș | de obicei nu |
În Postman alegi metoda din lista din stânga câmpului URL. Implicit este GET.
CRUD: patru operații pentru orice date
Aproape orice aplicație face patru lucruri cu datele ei. Programatorii le spun CRUD, de la inițialele în engleză:
| Litera | Operația | Metoda HTTP |
|---|---|---|
| Create | creezi | POST |
| Read | citești | GET |
| Update | modifici | PUT sau PATCH |
| Delete | ștergi | DELETE |
Diferența dintre PUT și PATCH contează: cu PUT trimiți toată resursa (dacă uiți un câmp, el poate dispărea), iar cu PATCH trimiți doar câmpurile pe care le schimbi. Gândește-te la un formular de profil: PUT înseamnă că retrimiți tot formularul, PATCH că schimbi doar numărul de telefon.
În cursul de testare manuală ai învățat să gândești cazuri de test pentru o funcționalitate. La API, fiecare metodă pe fiecare endpoint devine cel puțin un caz de test: „pot citi produsul?”, „pot crea un produs?”, „ce se întâmplă dacă șterg un produs care nu există?”.
Serverul de ecou îți arată metoda
La echo.test fiecare metodă are adresa ei: /get, /post, /put, /patch, /delete. Serverul îți întoarce exact cererea primită, inclusiv metoda. Iată un POST fără body:
POST https://echo.test/post
200 OK
{
"args": {},
"data": "",
"files": {},
"form": {},
"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"
},
"json": null,
"method": "POST",
"url": "https://echo.test/post"
}Câmpul method confirmă că a ajuns un POST. json este null și data este gol pentru că nu ai trimis niciun body. Cum trimiți date în body înveți în lecția 7.
Dacă trimiți cu metoda greșită la o adresă de pe echo.test (de exemplu GET la /post), serverul răspunde cu o eroare. Exact la fel se întâmplă la API-urile reale: metoda trebuie să se potrivească cu ce acceptă endpoint-ul.
GET nu are body
O cerere GET doar cere informații. Tot ce trebuie să spui serverului încape în URL, de exemplu /products/7 sau /products?category=carti. De aceea GET nu are body, iar unele servere chiar refuză un GET cu body.
GET https://api.magazin.test/products/7
200 OK
{
"id": 7,
"name": "Mouse wireless",
"sku": "MOUSE-WIRELE-007",
"price": 89,
"currency": "RON",
"category": "accesorii",
"stock": 120,
"rating": 4.3,
"active": true,
"createdAt": "2026-01-23T10:00:00.000Z"
}Când metoda nu este permisă pe o adresă, un server bine făcut răspunde cu 405 Method Not Allowed și îți spune în antetul Allow ce metode acceptă:
DELETE https://api.magazin.test/products
405 Method Not Allowed
Allow: GET, POST
{
"error": "method_not_allowed",
"message": "Metoda DELETE nu este permisă pe /products."
}Nimeni nu are voie să șteargă dintr-o dată tot catalogul, așa că /products acceptă doar GET și POST.
Idempotent: aceeași cerere, același efect
Un cuvânt pe care îl vei auzi la interviuri: idempotent. O metodă este idempotentă dacă repetarea ei de mai multe ori lasă serverul în aceeași stare ca o singură trimitere.
- GET este idempotent: dacă citești produsul 7 de zece ori, produsul rămâne neschimbat.
- PUT și DELETE sunt idempotente: rescrii același produs de două ori și rezultatul e același; ștergi același element de două ori și tot șters rămâne.
- POST nu este idempotent: două trimiteri ale aceleiași comenzi pot crea două comenzi.
De aici vine un bug clasic: utilizatorul apasă de două ori pe „Plătește” și primește două comenzi. Îl vei testa concret în lecția 48. Deocamdată reține doar ideea.
Greșeli frecvente
- Uiți să schimbi metoda. Ai scris adresa corectă, dar ai lăsat GET. Verifică mereu lista din stânga URL-ului înainte de Send.
- Folosești PUT când voiai PATCH. Cu PUT trimiți toată resursa; dacă trimiți doar un câmp, restul se poate pierde.
- Crezi că DELETE nu are nevoie de verificare. Ce se întâmplă dacă ștergi ceva ce nu există? Răspunsul corect este de obicei 404.
- Pui body pe un GET. Mută informația în URL, ca parametru.
Din aplicațiile reale
- Coșul de cumpărături: adaugi un produs (POST), schimbi cantitatea (PATCH), vezi coșul (GET), scoți produsul (DELETE).
- Profilul din aplicația băncii: citești datele (GET) și schimbi doar adresa de email (PATCH).
Folosește serverul de ecou ca să trimiți câte o cerere cu fiecare metodă și să vezi cum o primește serverul. Nu trimite body la niciuna.
- Trimite GET https://echo.test/get.
- Schimbă metoda în POST și trimite la https://echo.test/post.
- Trimite PUT la https://echo.test/put.
- Trimite DELETE la https://echo.test/delete și verifică în body câmpul method.
Soluția exercițiului
1. Metoda GET, URL https://echo.test/get, Send. 2. Metoda POST, URL https://echo.test/post, Send: în body vezi "method": "POST". 3. Metoda PUT, URL https://echo.test/put, Send. 4. Metoda DELETE, URL https://echo.test/delete, Send: în body vezi "method": "DELETE".
