Čo je API kľúč?
API kľúč je tajný unikátny identifikátor, ktorý slúži na autentifikáciu a autorizáciu pri prístupe k API. Funguje ako „heslo pre aplikácie" — identifikuje, kto volá API, a umožňuje poskytovateľovi sledovať a obmedzovať prístup.
Definícia API kľúč
Čo je API kľúč
API kľúč (z anglického API key) je tajný unikátny identifikátor, ktorý sa používa na autentifikáciu a autorizáciu pri prístupe k aplikačnému programovému rozhraniu (API). Veľkí poskytovatelia cloudových služieb ako Google Cloud Platform, Amazon AWS a Microsoft Azure používajú API kľúče na identifikáciu vývojárov a ich aplikácií.
API kľúč zvyčajne vyzerá ako dlhý náhodný reťazec znakov, napríklad: sk_live_4eC39HqLyjWDarjtT1zdp7dc. Posiela sa v HTTP hlavičke, URL parametri alebo tele požiadavky.
Ako API kľúče fungujú
- Identifikácia — kľúč identifikuje aplikáciu alebo vývojára, ktorý posiela požiadavku
- Autorizácia — na základe kľúča server určí, k akým zdrojom má volajúci prístup
- Rate limiting — poskytovateľ sleduje počet požiadaviek na kľúč a aplikuje limity
- Účtovanie — pri platených API sa na základe kľúča počíta spotreba a generujú faktúry
Dôležité bezpečnostné pravidlá: API kľúč nikdy neukladajte do zdrojového kódu ani do verejného repozitára. Používajte premenné prostredia (.env súbory), rotujte kľúče pravidelne a obmedzte oprávnenia na minimum potrebné pre danú aplikáciu.
Praktický príklad
Príklad: Chcete na webe zobraziť mapu pomocou Google Maps API.
Zaregistrujete sa v Google Cloud Console, vytvoríte projekt a vygenerujete API kľúč. Tento kľúč pridáte do volania: <script src="https://maps.googleapis.com/maps/api/js?key=VÁŠ_API_KĽÚČ">. Google na základe kľúča vie, kto mapu používa, a môže účtovať poplatky za presiahnutie bezplatného limitu.
Často kladené otázky
Čo je API kľúč a na čo slúži?
API kľúč je tajný identifikátor, ktorý aplikácia posiela pri volaní API. Slúži na identifikáciu volajúceho, riadenie prístupu, sledovanie spotreby a účtovanie. Funguje ako heslo pre komunikáciu medzi aplikáciami.
Ako bezpečne uložiť API kľúč?
Nikdy neukladajte API kľúč priamo do zdrojového kódu. Používajte premenné prostredia (.env súbory), tajné úložiská (AWS Secrets Manager, HashiCorp Vault) a pridajte .env do .gitignore, aby sa nedostal do repozitára.
Aký je rozdiel medzi API kľúčom a OAuth tokenom?
API kľúč identifikuje aplikáciu a je dlhodobo platný. OAuth token reprezentuje povolenie konkrétneho používateľa, má obmedzenú platnosť a presne definované oprávnenia (scopes). Pre prístup k dátam používateľov je OAuth bezpečnejší.
Čo robiť, ak mi unikne API kľúč?
Okamžite kľúč zrušte (revoke) v dashboarde poskytovateľa a vygenerujte nový. Skontrolujte logy na neautorizované použitie. Služby ako GitHub automaticky skenujú verejné repozitáre a upozornia, ak nájdu uniknutý kľúč.
Súvisiace pojmy
Potrebujete pomôcť s webom?
Napíšte mi a poradím vám s vaším projektom. Prvá konzultácia je zadarmo a nezáväzná.