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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
„Invalid authentication credentials” e mesajul gateway-ului Kong când cheia trimisă nu există; alte API-uri răspund invalid_api_key, „Invalid API key” sau, ca în API-ul demo, 403 cu invalid_api_key. Spre deosebire de „cheie lipsă”, aici antetul există, dar valoarea nu e acceptată.
Cauze frecvente:
- o greșeală în valoare: o literă lipsă, un spațiu sau un rând nou copiat la final;
- cheia altui mediu (cheia de producție pe Staging sau invers);
- cheie revocată sau expirată;
- cheia pusă în Initial value, iar Current value conține altceva (sau invers, după ce ai editat doar una dintre ele).
Statusul depinde de API: unele dau 401 (credențiale invalide), altele 403 (știu cine încearcă, dar refuz). Ca tester, verifici că răspunsul nu spune prea mult (de exemplu „cheia există, dar e revocată” ajută un atacator).
De ce apare: cauzele frecvente
1Valoare greșită
Dev: apiKey = cheie-demo-12Dev: apiKey = cheie-demo-123Cheia trebuie să fie exact cea emisă.
2Spațiu copiat la final
x-api-key: cheie-demo-123x-api-key: cheie-demo-123Spațiile fac parte din valoare.
3Cheia altui mediu
Environment: Staging, apiKey = cheia de DevEnvironment: Staging, apiKey = cheia de StagingFiecare mediu are propriile chei.
Repară eroarea, direct în pagină
Cererea „Raport vânzări” trimite antetul x-api-key: {{apiKey}}, dar valoarea din environment-ul Dev are o cifră lipsă (cheie-demo-12), deci serverul răspunde 403 invalid_api_key. Corectează apiKey în cheie-demo-123 și trimite din nou: trebuie să primești 200.
Indiciu
Compară valoarea din environment cu cheia corectă, caracter cu caracter.
Reparația
Environment Dev → apiKey = cheie-demo-123. Trimite din nou.
De ce merge
Cheia era prezentă, dar nu corespundea niciunei chei emise, deci serverul o refuza. Cu valoarea exactă, verificarea trece. Cheia a fost găsită, dar nu e validă pentru acest API sau mediu. Cu valoarea corectă, verificarea reușește și endpoint-ul răspunde cu datele cerute.
Alte forme ale mesajului
403 Forbidden: invalid_api_key{"message": "Invalid API key"}401 Unauthorized: Invalid API Key
Cum o eviți pe viitor
- Copiază cheile direct din sursa lor (portal, manager de secrete), nu le rescrie.
- Ține câte o cheie pe environment.
- Testează explicit cheia greșită și cheia lipsă, cu statusurile documentate.
- Ține cheile în variabile secrete și verifică-le valoarea curentă când primești 401 sau 403.
Întrebări frecvente
De ce primesc 403 și nu 401?
Unele API-uri consideră că o cheie greșită înseamnă acces interzis. Contează să fie consecvent și documentat.
Cum verific ce cheie a plecat?
În Console, la antetele cererii, vezi valoarea exactă trimisă.
Erori înrudite
No API key found in request Endpointul cere o cheie API, dar cererea nu o conține (în antetul sau parametrul așteptat). Adaugă cheia din tabul Authorization → API Key, cu numele exact din documentație (de exemplu x-api-key) și locul corect (antet sau query). 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. Variabila are altă valoare decât cea setată: precedența scope-urilor Aceeași variabilă există în mai multe scope-uri, iar Postman o folosește pe cea mai îngustă: local, data, environment, colecție, global. Ai schimbat valoarea într-un scope mai larg, dar câștigă cea veche dintr-unul mai îngust. Șterge dublura sau modifică valoarea în scope-ul care câștigă. Î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.
