401 Unauthorized: Antetul Authorization trebuie să fie de forma Bearer <token>
Ai pus tokenul direct în antetul Authorization, fără cuvântul Bearer în față, așa că serverul nu recunoaște schema. Folosește tabul Authorization cu tipul Bearer Token (care adaugă prefixul) sau scrie antetul complet: Authorization: Bearer {{token}}.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Antetul Authorization are forma <schemă> <credențiale>: Bearer eyJ..., Basic YW5h.... Serverul citește întâi schema ca să știe cum să interpreteze restul. Dacă trimiți doar tokenul, Authorization: eyJ..., serverul nu găsește nicio schemă cunoscută și răspunde 401 (mesajul diferă: „Invalid authorization header format”, „Bearer token required”).
Se întâmplă când antetul e scris de mână în tabul Headers în loc să folosești tabul Authorization, sau când un script face pm.request.headers.upsert({key: "Authorization", value: token}).
Cea mai sigură variantă e tabul Authorization → Bearer Token cu {{token}}: Postman construiește antetul corect. Dacă scrii antetul manual, cuvântul Bearer, urmat de un spațiu, e obligatoriu.
De ce apare: cauzele frecvente
1Antet manual fără schemă
Headers: Authorization: {{token}}Authorization → Bearer Token: {{token}}Tipul Bearer Token adaugă singur prefixul.
2Script fără prefix
pm.request.headers.upsert({ key: "Authorization", value: pm.environment.get("token") });pm.request.headers.upsert({ key: "Authorization", value: "Bearer " + pm.environment.get("token") });Prefixul trebuie adăugat explicit când construiești antetul din cod.
Repară eroarea, direct în pagină
Cererea „Profil” are autentificarea pe No Auth și un antet scris de mână Authorization: {{token}}, fără prefixul Bearer, deci serverul răspunde 401. Schimbă valoarea antetului în Bearer {{token}}, salvează cererea, trimite Login și apoi Profil: trebuie să primești 200.
Indiciu
Schema Bearer, urmată de un spațiu, vine înaintea tokenului.
Reparația
Headers: Authorization = Bearer {{token}}. Mai simplu: șterge antetul manual și pune cererea pe Inherit auth from parent, iar colecția trimite Bearer {{token}}.
De ce merge
Serverul citește întâi schema din antet. Cu Bearer în față, știe că urmează un JWT și îl verifică. Serverul așteaptă formatul Bearer <token>. Fără prefix, nu recunoaște schema și respinge cererea; cu tipul Bearer Token, Postman construiește antetul corect.
Alte forme ale mesajului
401: Invalid authorization header formatBearer token requiredAuthorization header must start with Bearer
Cum o eviți pe viitor
- Folosește tabul Authorization în locul antetelor scrise de mână.
- Dacă ai nevoie de antet manual, scrie
Bearer {{token}}, cu un spațiu. - Verifică în Console forma exactă a antetului trimis.
- Folosește tabul Authorization cu tipul Bearer Token, care adaugă prefixul automat.
Întrebări frecvente
Contează litera mare la Bearer?
Standardul spune că schema nu e sensibilă la majuscule, dar unele servere compară exact; scrie Bearer.
Și cheile API au prefix?
Depinde de API. Multe folosesc un antet separat (X-API-Key), fără prefix.
Erori înrudite
Missing Authorization Header Cererea nu trimite antetul Authorization, deși endpointul îl cere: de obicei cererea are No Auth în loc de Inherit auth from parent, sau tokenul colecției e gol. Setează autentificarea cererii pe Inherit (sau Bearer {{token}}) și verifică antetul în Console. 401 după login: tokenul a fost salvat cu ghilimele Tokenul din variabilă are ghilimele în jur (de exemplu salvat cu JSON.stringify sau copiat din body), deci antetul pleacă Bearer "eyJ..." și serverul îl respinge. Salvează valoarea direct, fără JSON.stringify și fără ghilimele. 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. Î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.
