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).
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țiapi-keysauAuthorization; - 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
GET {{baseUrl}}/reports/salesGET {{baseUrl}}/reports/sales
Authorization: API Key, Key = x-api-key, Value = {{apiKey}}, Add to = HeaderServerul caută antetul x-api-key.
2Nume de antet greșit
Headers: api-key: {{apiKey}}Headers: x-api-key: {{apiKey}}Numele trebuie să fie exact cel din documentație (fără diferențe de majuscule).
3Variabila cheii e goală
Dev: apiKey = ""Dev: apiKey = cheia ta (Current value)O variabilă goală produce un antet gol sau nu se trimite deloc.
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.
Reparația
Authorization → API Key: Key = x-api-key, Value = {{apiKey}}, Add to = Header. Salvează și trimite.
De ce merge
Serverul caută cheia în antetul x-api-key. Cu tipul API Key, Postman adaugă antetul cu valoarea din environment la fiecare trimitere, iar cheia rămâne într-un singur loc. Serverul caută cheia într-un loc precis, cu un nume precis. Când antetul are numele documentat, cheia e găsită și verificată, iar cererea primește datele.
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
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. 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. 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. Î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.
