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

403 Forbidden

Pe scurt

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

Greșit
JavaScript
Login: ana@magazin.test
GET {{baseUrl}}/users
Corect
JavaScript
Login: admin@magazin.test
GET {{baseUrl}}/users

Doar rolul admin are acces la lista de utilizatori.

2Resursa altui utilizator

Greșit
JavaScript
Token Ana
GET {{baseUrl}}/orders/1002   # comanda lui Mihai
Corect
JavaScript
Token Ana
GET {{baseUrl}}/orders/1001   # comanda Anei

Un client își vede doar comenzile proprii.

3Scope OAuth insuficient

Greșit
JavaScript
scope=read
Corect
JavaScript
scope=read write

Tokenul trebuie să includă permisiunea pentru operație.

Repară tu

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.

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

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