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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
405 spune că serverul recunoaște calea, dar nu și metoda. Răspunsul corect conține antetul Allow cu metodele permise, de exemplu Allow: GET, POST.
În Postman, cauzele obișnuite sunt:
- metoda a rămas cea veche după ce ai schimbat URL-ul (o cerere duplicată dintr-un POST);
- ai trimis PUT, PATCH sau DELETE pe colecție (
/products) în loc de element (/products/7); - documentația spune PATCH, iar tu ai trimis PUT (sau invers);
- unele servere răspund 405 când lipsește bara finală sau există una în plus, pentru că ajungi pe altă rută.
Ca test negativ, 405 e un rezultat bun: operațiile periculoase pe toată colecția (un DELETE pe /products) trebuie refuzate.
De ce apare: cauzele frecvente
1Metodă greșită rămasă de la duplicare
DELETE {{baseUrl}}/productsGET {{baseUrl}}/productsLista se citește cu GET; DELETE pe toată lista nu e permis.
2Operație pe colecție în loc de element
PATCH {{baseUrl}}/productsPATCH {{baseUrl}}/products/7Modificarea se face pe un produs anume.
Repară eroarea, direct în pagină
Cererea „Listă produse” a fost duplicată dintr-o altă cerere și a rămas cu metoda DELETE, deci serverul răspunde 405. Schimbă metoda în GET, salvează cererea și trimite-o: trebuie să primești 200.
Indiciu
Metoda se alege din dropdown-ul din stânga URL-ului.
Reparația
Metoda: GET. Salvează și trimite.
De ce merge
Pe /products serverul acceptă GET (listare) și POST (creare, pentru admin), dar nu DELETE pe toată lista, de aceea răspundea 405. Cu GET, cererea face ce îi spune numele. Calea există, dar nu acceptă metoda trimisă. Cu metoda din documentație, serverul găsește operația potrivită și răspunde normal, fără să mai respingă cererea.
Alte forme ale mesajului
405 Method Not Allowed: Metoda DELETE nu este permisă pe /products.Cannot DELETE /productsHTTP 405
Cum o eviți pe viitor
- Verifică metoda de fiecare dată când duplici o cerere.
- Pune metoda în numele cererii (
GET Listă produse), ca greșeala să sară în ochi. - Citește antetul
Allowdin răspunsul 405. - Uită-te la antetul
Allowdin răspunsul 405: listează metodele acceptate.
Întrebări frecvente
E la fel cu 404?
Nu. 404: calea nu există. 405: calea există, dar nu cu această metodă.
Ce înseamnă antetul Allow?
Lista metodelor acceptate pe acea cale, de exemplu Allow: GET, HEAD.
Erori înrudite
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. 400 Bad Request Serverul a primit cererea, dar o consideră greșit formată: un parametru invalid, JSON stricat, un câmp de tip greșit. Citește body-ul răspunsului (de obicei spune exact ce parametru e greșit) și corectează cererea. AssertionError: expected response to have status code 200 but got 201 Testul cere statusul 200, dar serverul a răspuns 201 Created. Pentru o creare reușită, 201 e răspunsul corect, deci testul greșește: verifică statusul pe care îl promite documentația endpoint-ului. Î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.
