403 Forbidden
Serverul știe cine ești, dar contul tău nu are dreptul la această operație sau resursă (de exemplu un client care cere lista de utilizatori, rezervată adminilor). Folosește un cont cu rolul potrivit; dacă ar trebui să ai acces, raportează problema de permisiuni.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
403 Forbidden vine după autentificare: identitatea e validă, dar autorizarea refuză accesul. Exemple tipice:
- un client apelează un endpoint de admin (
GET /users,POST /products); - un utilizator cere resursa altuia (comanda altui client);
- cheia API e validă, dar nu are permisiunea pentru acea operație sau scope-ul OAuth nu o include.
În Postman, cauza cea mai frecventă e tokenul greșit: ai făcut login cu Ana, apoi testezi o cerere de admin, iar tokenul salvat e tot al Anei. Decodează tokenul (sau apelează /auth/me) ca să vezi cu ce rol trimiți cererea.
Pentru tester, 403 e și un rezultat așteptat: testele de autorizare verifică exact că un client primește 403 pe operațiile interzise.
De ce apare: cauzele frecvente
1Token de client pe endpoint de admin
Login: ana@magazin.test
GET {{baseUrl}}/usersLogin: admin@magazin.test
GET {{baseUrl}}/usersDoar rolul admin are acces la lista de utilizatori.
2Resursa altui utilizator
Token Ana
GET {{baseUrl}}/orders/1002 # comanda lui MihaiToken Ana
GET {{baseUrl}}/orders/1001 # comanda AneiUn client își vede doar comenzile proprii.
3Scope OAuth insuficient
scope=readscope=read writeTokenul trebuie să includă permisiunea pentru operație.
Repară eroarea, direct în pagină
Cererea „Utilizatori” (GET {{baseUrl}}/users) e rezervată adminilor, dar tokenul salvat e al Anei (client), deci răspunsul e 403. Colecția are și cererea „Login admin”, care salvează un token de admin în aceeași variabilă. Trimite-o, apoi trimite din nou „Utilizatori”: trebuie să primești 200.
Indiciu
Rolul vine din tokenul folosit.
Reparația
1. Trimite Login admin (salvează tokenul adminului în token). 2. Trimite Utilizatori.
De ce merge
Serverul știa cine e Ana și a refuzat corect accesul. Cu tokenul adminului, identitatea are rolul cerut. Într-o colecție mai mare, ai ține tokenuri separate (tokenClient, tokenAdmin) și foldere cu autentificarea potrivită, ca să nu le suprascrii unul pe altul.
Alte forme ale mesajului
403 Forbidden: Nu ai drepturi pentru această operație.HTTP 403{"error": "forbidden"}
Cum o eviți pe viitor
- Ține tokenuri separate pe rol (
tokenClient,tokenAdmin) și foldere cu autentificarea potrivită. - Verifică rolul din token când apare un 403 neașteptat.
- Scrie intenționat teste care așteaptă 403 pentru operațiile interzise.
- Ține un utilizator de test pentru fiecare rol și numește cererile după rolul folosit.
Întrebări frecvente
E bug dacă primesc 403?
Nu, dacă rolul tău chiar nu are voie. E bug dacă un rol care ar trebui să aibă acces e refuzat, sau, mult mai grav, dacă un rol fără drept primește 200.
De ce unele API-uri răspund 404 în loc de 403?
Ca să nu dezvăluie că resursa există. E o alegere de securitate validă, dacă e consecventă.
Erori înrudite
401 Unauthorized Serverul nu știe cine ești: tokenul lipsește, e expirat sau invalid, sau cheia API nu e trimisă. Obține un token nou (login) și verifică în Console că antetul Authorization chiar pleacă cu cererea. Invalid authentication credentials Cheia API (sau credențialele) e prezentă, dar serverul nu o recunoaște: e greșită, expirată, revocată sau aparține altui mediu. Verifică valoarea exactă din environment (spații, caractere lipsă) și cere o cheie validă pentru mediul curent. 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.
