...
Eroare Postman · Autentificare și tokenuri

Invalid authentication credentials

Pe scurt

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ă

Greșit
JavaScript
Dev: apiKey = cheie-demo-12
Corect
JavaScript
Dev: apiKey = cheie-demo-123

Cheia trebuie să fie exact cea emisă.

2Spațiu copiat la final

Greșit
JavaScript
x-api-key: cheie-demo-123
Corect
JavaScript
x-api-key: cheie-demo-123

Spațiile fac parte din valoare.

3Cheia altui mediu

Greșit
JavaScript
Environment: Staging, apiKey = cheia de Dev
Corect
JavaScript
Environment: Staging, apiKey = cheia de Staging

Fiecare mediu are propriile chei.

Repară tu

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.

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

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