Prehľad autentifikácie

Táto príručka vysvetľuje, ako sa autentifikovať voči nášmu API. Podporujeme niekoľko metód autentifikácie:

API kľúče

Najjednoduchšou metódou autentifikácie je použitie API kľúčov. Každý API kľúč je priradený konkrétnemu používateľovi a má konkrétne oprávnenia.

// Example API Key request
const response = await fetch('https://api.example.com/data', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

OAuth 2.0

Pre bezpečnejšie aplikácie podporujeme autentifikačný tok OAuth 2.0:

1. Žiadosť o autorizáciu: Presmerujte používateľov na našu autorizačnú URL
2. Súhlas používateľa: Používateľ schváli prístup k svojmu účtu
3. Autorizačný kód: Náš server vráti autorizačný kód
4. Výmena tokenu: Vymeňte kód za prístupový token
5. API požiadavky: Použite prístupový token na prístup k chráneným zdrojom

JWT tokeny

Po autentifikácii vydávame JWT tokeny, ktoré obsahujú zakódované informácie o používateľovi a jeho oprávneniach.

// Example JWT token usage
const response = await fetch('https://api.example.com/protected-resource', {
  headers: {
    'Authorization': 'Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'
  }
});

Správa relácií

Relácie sú predvolene platné 24 hodín. Reláciu obnovíte takto:

const refreshResponse = await fetch('https://api.example.com/auth/refresh', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer CURRENT_REFRESH_TOKEN'
  }
});

// Parse the new tokens
const { accessToken, refreshToken } = await refreshResponse.json();

Osvedčené postupy

1. Nikdy neukladajte API kľúče ani tokeny do kódu na strane klienta
2. Na citlivé prihlasovacie údaje používajte premenné prostredia
3. V dlhodobo bežiacich aplikáciách implementujte mechanizmy obnovy tokenov
4. Nastavte primeranú dobu platnosti tokenov
5. Pre všetky API požiadavky používajte HTTPS