...
Eroare Postman · Autentificare și tokenuri

No API key found in request

Pe scurt

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

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Mesajul „No API key found in request” e cel al gateway-ului Kong; alte servere spun „Missing API key” sau, în API-ul demo, missing_api_key cu 401. Sensul e același: cererea nu are cheia acolo unde o caută serverul.

Cauze frecvente:

  • cheia lipsește complet (cerere nouă, fără autentificare);
  • numele antetului diferă: documentația cere x-api-key, tu trimiți api-key sau Authorization;
  • locul diferă: serverul o caută în antet, tu o pui în query (sau invers);
  • variabila {{apiKey}} e goală, iar Postman nu mai adaugă antetul.

În tabul Authorization alegi tipul API Key, completezi Key (numele antetului sau al parametrului), Value ({{apiKey}}) și Add to (Header sau Query Params). Postman construiește singur antetul sau parametrul.

De ce apare: cauzele frecvente

1Cheia lipsește

Greșit
JavaScript
GET {{baseUrl}}/reports/sales
Corect
JavaScript
GET {{baseUrl}}/reports/sales
Authorization: API Key, Key = x-api-key, Value = {{apiKey}}, Add to = Header

Serverul caută antetul x-api-key.

2Nume de antet greșit

Greșit
JavaScript
Headers: api-key: {{apiKey}}
Corect
JavaScript
Headers: x-api-key: {{apiKey}}

Numele trebuie să fie exact cel din documentație (fără diferențe de majuscule).

3Variabila cheii e goală

Greșit
JavaScript
Dev: apiKey = ""
Corect
JavaScript
Dev: apiKey = cheia ta (Current value)

O variabilă goală produce un antet gol sau nu se trimite deloc.

Repară tu

Repară eroarea, direct în pagină

Raportul GET {{baseUrl}}/reports/sales cere o cheie API în antetul x-api-key, dar cererea nu o trimite și primește 401 missing_api_key. Environment-ul Dev are deja variabila apiKey. Configurează în tabul Authorization al cererii tipul API Key (cheia x-api-key, valoarea {{apiKey}}, în Header), salvează și trimite: trebuie să primești 200.

Indiciu

Tipul API Key din tabul Authorization.

Alte forme ale mesajului

  • 401 Unauthorized: missing_api_key
  • {"message": "No API key found in request"}
  • Missing API key

Cum o eviți pe viitor

  • Ține cheia API în environment, doar în Current value.
  • Setează API Key la nivel de colecție sau folder, cu Inherit pe cereri.
  • Testează explicit cererea fără cheie: răspunsul așteptat e 401.
  • Notează în descrierea colecției numele exact al antetului sau parametrului pentru cheie.

Întrebări frecvente

Antet sau query?

Antetul e mai sigur: query-ul ajunge în loguri și în istoric. Folosește ce cere documentația.

Ce diferență e față de cheie greșită?

Fără cheie: 401 (lipsă). Cheie greșită: 401 sau 403, după API (cheie invalidă).

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.