...
Eroare Postman · Coduri de status 4xx și 5xx: ce înseamnă și cum le repari

404 Not Found

Pe scurt

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

Greșit
JavaScript
GET {{baseUrl}}/product/7
Corect
JavaScript
GET {{baseUrl}}/products/7

Resursele sunt de obicei la plural în API-urile REST.

2Id inexistent

Greșit
JavaScript
GET {{baseUrl}}/products/999
Corect
JavaScript
GET {{baseUrl}}/products/7

Catalogul demo are produsele 1–30.

3Spațiu sau caracter ascuns în URL

Greșit
JavaScript
GET {{baseUrl}}/products /7
Corect
JavaScript
GET {{baseUrl}}/products/7

Textul copiat din documente poate aduce spații invizibile.

Repară tu

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.

Alte forme ale mesajului

  • 404 Not Found: Ruta GET /product/7 nu există.
  • Cannot GET /api/product/7
  • HTTP 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

← Toate erorile Postman

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.