301 Moved Permanently în loc de răspunsul așteptat
Adresa cerută a fost mutată, iar serverul îți spune unde prin antetul Location. Dacă ai dezactivat „Automatically follow redirects”, vezi 301 în loc de pagina finală. Folosește direct adresa nouă din Location sau reactivează urmarea redirecționărilor.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
301 Moved Permanently nu e o eroare, ci o indicație: resursa are o adresă nouă, aflată în antetul Location. Codul e în familia 3xx, nu 4xx, dar apare des când testele așteaptă 200.
Implicit, Postman urmează redirecționările și îți arată direct răspunsul final. Vezi 301 doar dacă:
- ai dezactivat Automatically follow redirects în Settings-ul cererii (de exemplu ca să testezi chiar redirecționarea);
- ai setat la fel în setările globale sau în Newman (
--ignore-redirects).
Ce faci depinde de scop. Dacă testezi endpointul, actualizezi URL-ul la adresa din Location: e mai rapid și evită pierderea body-ului (la 301 și 302, un POST devine GET când e urmat). Dacă testezi redirecționarea, verifici chiar statusul 301 și antetul.
Un caz frecvent: http:// redirecționat spre https://.
De ce apare: cauzele frecvente
1Adresă veche, urmărirea dezactivată
GET {{baseUrl}}/catalog (follow redirects: off)GET {{baseUrl}}/productsAdresa nouă răspunde direct cu 200.
2POST care se pierde prin redirecționare
POST http://api.magazin.test/orders → 301 → GET https://...POST https://api.magazin.test/ordersLa 301/302 metoda devine GET, iar body-ul se pierde.
Repară eroarea, direct în pagină
Cererea „Catalog” cere adresa veche {{baseUrl}}/catalog, cu urmarea redirecționărilor dezactivată, și primește 301 cu Location spre /products, iar testul ei pe 200 pică. Schimbă URL-ul la adresa nouă din antetul Location, salvează cererea și trimite-o: testul trebuie să treacă.
Indiciu
Adresa nouă e în antetul Location al răspunsului 301.
Reparația
{{baseUrl}}/productsDe ce merge
Serverul spunea prin Location unde s-a mutat resursa. Cu adresa nouă, cererea primește direct 200, fără ocolul prin redirecționare. 301 spune că resursa are o adresă nouă, dată în antetul Location. Cu URL-ul actualizat, cererea ajunge direct la destinație, fără un pas în plus, iar metoda și body-ul nu se mai pierd pe drum.
Alte forme ale mesajului
302 Found în loc de 200308 Permanent Redirect
Cum o eviți pe viitor
- Actualizează URL-urile când primești 301; nu te baza pe redirecționări în teste.
- Ține
baseUrldirect pehttps://. - Când testezi redirecționarea, dezactivează urmarea doar pe acea cerere.
- Actualizează URL-urile din colecție după redirecționări permanente.
- Testează și redirecționarea în sine, cu urmărirea automată oprită.
Întrebări frecvente
Ce diferență e între 301 și 302?
301: mutare permanentă (actualizează adresa). 302: temporară. 307 și 308 sunt echivalentele care păstrează metoda și body-ul.
Unde văd redirecționările urmate?
În Console: Postman afișează fiecare pas al redirecționării.
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. 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. AssertionError: expected response to have header with key 'X-Total-Items' Răspunsul nu are antetul pe care îl cere testul. Verifică în tabul Headers numele exact (aici API-ul folosește X-Total-Count) și dacă endpoint-ul chiar trimite acel antet (listele da, un singur produs nu). Î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.
