401 Unauthorized confundat cu 403 Forbidden
401 înseamnă că serverul nu știe cine ești (lipsește tokenul sau e invalid/expirat); 403 înseamnă că știe cine ești, dar nu ai voie. Un test API care acceptă oricare dintre ele nu prinde bug-uri de autorizare. Scrie în rezultatul așteptat codul exact pentru fiecare situație.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
La testarea unui API, codurile de status sunt rezultatul așteptat principal. Două dintre ele sunt confundate foarte des:
- 401 Unauthorized: cererea nu are o autentificare validă. Tokenul lipsește, e greșit sau a expirat. Numele e istoric și înșelător: e vorba de autentificare (cine ești), nu de permisiuni;
- 403 Forbidden: autentificarea e validă, dar utilizatorul nu are dreptul la resursa sau operația cerută (de exemplu un client care încearcă să șteargă un produs, operație permisă doar administratorilor).
Confuzia contează în teste. Dacă un client autentificat primește 401 la o operație interzisă, aplicația îi spune greșit că tokenul nu e bun, iar el se reautentifică la nesfârșit. Dacă un test acceptă „401 sau 403”, nu verifică de fapt nicio regulă. Fiecare scenariu de autorizare are un cod exact așteptat.
De ce apare: cauzele frecvente
1Rezultat așteptat „eroare de acces”
DELETE /produse/5 cu tokenul unui client
Rezultat așteptat: 401 sau 403DELETE /produse/5 fără token → 401
DELETE /produse/5 cu tokenul unui client → 403
DELETE /produse/5 cu tokenul unui administrator → 204Fiecare situație are alt cod. Un test care acceptă ambele nu vede dacă serverul confundă autentificarea cu permisiunile.
2Token expirat tratat ca lipsă de drepturi
Token expirat → răspuns 403 → „ok, nu are acces”Token expirat → răspuns așteptat 401 (clientul trebuie să se reautentifice)403 spune că reautentificarea nu ajută; clientul nu mai încearcă și rămâne blocat.
Corectează greșeala, direct în pagină
Testezi endpoint-ul DELETE /produse/5 al API-ului ShopRapid, permis doar administratorilor. Un coleg a scris la toate cazurile „Rezultat așteptat: 401 sau 403”. Răspunde corect la întrebările din tab-ul Quiz, ca să stabilești codul exact pentru fiecare situație.
Indiciu
401 = nu știu cine ești; 403 = știu cine ești, dar nu ai voie.
Reparația
Răspunsurile corecte:
1. q1: Fără Authorization → 401; client fără drept → 403; administrator → 204; administrator, produs inexistent → 404. 2. q2: 401, pentru că autentificarea nu mai e validă. 3. q3: Fals.
De ce merge
Cele două coduri răspund la întrebări diferite: 401 la „cine ești?”, 403 la „ai voie?”. Cu un cod exact pe fiecare caz, testele prind atât endpoint-urile neprotejate, cât și serverele care trimit utilizatorii autentificați să se reautentifice degeaba.
Cazurile pentru administrator (204 și 404) completează imaginea: aceeași cerere, cu drepturi, trebuie să meargă sau să spună clar că resursa nu există.
Alte forme ale mesajului
401 vs 403HTTP 401 UnauthorizedHTTP 403 Forbidden
Cum o eviți pe viitor
- Pentru fiecare endpoint protejat, testează trei situații: fără token, cu utilizator fără drepturi, cu utilizator cu drepturi.
- Scrie un singur cod așteptat pe fiecare caz.
- Testează și tokenul expirat sau modificat.
- Verifică și corpul răspunsului: mesajul spune corect problema?
- Ține la îndemână lista codurilor folosite de API (din documentație).
Întrebări frecvente
Când se folosește 404 în loc de 403?
Unele API-uri răspund 404 la resursele altui utilizator, ca să nu dezvăluie că ele există. E o decizie de design; testul trebuie să urmeze ce spune documentația API-ului.
De ce se numește 401 „Unauthorized” dacă e despre autentificare?
E un nume istoric din specificația HTTP. În practică, 401 = neautentificat, 403 = autentificat, dar fără permisiune.
Greșeli înrudite
Verificat doar status 200 la API, nu și corpul răspunsului Un răspuns 200 OK spune doar că cererea a fost procesată, nu că datele sunt corecte: corpul poate avea prețul greșit, un câmp lipsă sau o listă goală. Verifică în fiecare test și corpul: câmpurile obligatorii, tipurile și valorile așteptate. Doar teste pozitive (doar „happy path”) Dacă testezi doar drumul fericit (date corecte, pași în ordinea normală), afli doar că aplicația merge când utilizatorul nu greșește niciodată. Adaugă cazuri negative: parolă greșită, email inexistent, câmpuri goale, valori în afara limitelor, fiecare cu mesajul așteptat. Rezultat așteptat vag („funcționează corect”) „Reducerea funcționează corect” nu e un rezultat așteptat: nu ai cu ce să compari, așa că un total greșit poate trece drept Pass. Scrie valorile concrete (Reducere −24,90 lei, Total 224,10 lei), calculate din cerință, și compară-le cu ce afișează aplicația. Învață Testare manuală de la zero, cu exerciții la fiecare lecție
Curs Testare manuală (QA): lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 12 lecții sunt gratuite.
