404 Not Found
Serverul nu are resursa sau ruta cerută: calea e scrisă greșit (singular/plural, versiune lipsă), id-ul nu există sau metoda și calea nu se potrivesc. Compară URL-ul final din Console cu documentația și verifică id-ul.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
404 Not Found are două sensuri, iar body-ul te ajută să le deosebești:
- ruta nu există:
/product/7în loc de/products/7, un prefix de versiune lipsă (/v1), o bară în plus, un spațiu copiat; - resursa nu există: ruta e corectă, dar produsul 999 nu e în baza de date. Un API bun spune asta explicit („Produsul 999 nu există”).
Primul caz e o greșeală în cerere. Al doilea poate fi rezultatul așteptat al unui test negativ sau semn că datele de test lipsesc pe mediul curent.
Atenție la mediu: un endpoint nou poate exista pe Dev, dar nu și pe Staging. Iar unele servere răspund 404 cu o pagină HTML, caz în care pm.response.json() dă o eroare suplimentară de parsare.
De ce apare: cauzele frecvente
1Calea scrisă greșit
GET {{baseUrl}}/product/7GET {{baseUrl}}/products/7Resursele sunt de obicei la plural în API-urile REST.
2Id inexistent
GET {{baseUrl}}/products/999GET {{baseUrl}}/products/7Catalogul demo are produsele 1–30.
3Spațiu sau caracter ascuns în URL
GET {{baseUrl}}/products /7GET {{baseUrl}}/products/7Textul copiat din documente poate aduce spații invizibile.
Repară eroarea, direct în pagină
Cererea „Un produs” are URL-ul {{baseUrl}}/product/7 și primește 404: ruta nu există. Corectează calea după convenția API-ului (resursele sunt la plural), salvează cererea și trimite-o: trebuie să primești 200 cu produsul 7.
Indiciu
Compară cu cererea Listă produse.
Reparația
{{baseUrl}}/products/7De ce merge
Ruta /product/7 nu e definită pe server, de aceea răspunsul spunea că ruta nu există. Cu /products/7, ruta există și produsul 7 e în catalog. 404 poate însemna o cale greșită sau o resursă inexistentă; body-ul de eroare te ajută să le deosebești. După corectare, URL-ul indică o resursă reală, iar serverul răspunde 200.
Alte forme ale mesajului
404 Not Found: Ruta GET /product/7 nu există.Cannot GET /api/product/7HTTP 404
Cum o eviți pe viitor
- Copiază căile din documentație sau din colecția importată din OpenAPI.
- Folosește ID-uri de test cunoscute, ținute în variabile.
- Pentru testele negative, verifică și mesajul din body, nu doar statusul.
- Ține id-urile de test în variabile, cu valori care există pe fiecare mediu.
Întrebări frecvente
Cum deosebesc ruta greșită de resursa lipsă?
Din body: un API bun scrie „Ruta ... nu există” sau „Produsul ... nu există”. Dacă body-ul e HTML generic, ruta e cel mai probabil greșită.
De ce merge pe Dev și dă 404 pe Staging?
Endpointul sau datele de test pot să nu existe încă pe Staging.
Erori înrudite
405 Method Not Allowed Ruta există, dar nu acceptă metoda HTTP trimisă (de exemplu DELETE pe lista de produse sau POST pe un endpoint doar de citire). Verifică metoda din dropdown-ul de lângă URL și antetul Allow din răspuns, care spune metodele permise. 400 Bad Request la /products/:id: variabila de cale nu are valoare URL-ul conține o variabilă de cale (:id), dar în Params → Path Variables valoarea ei e goală, deci cererea pleacă literal cu „:id”. Completează valoarea în tabelul Path Variables (sau folosește {{productId}} acolo). Răspunsul e HTML în loc de JSON (Content-Type: text/html) Endpointul unui API JSON a întors o pagină HTML (des la erori 404 sau 500), deci clienții nu pot citi eroarea. Dacă URL-ul e corect, e un bug de contract: scrie un test pe Content-Type și raportează-l cu cererea atașată. Învață Postman de la zero, cu exerciții la fiecare lecție
Curs API Testing cu Postman: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.
