Oversikt over autentisering

Denne veiledningen forklarer hvordan du autentiserer deg mot API-et vårt. Vi støtter flere autentiseringsmetoder:

API-nøkler

Den enkleste autentiseringsmetoden er å bruke API-nøkler. Hver API-nøkkel er knyttet til en bestemt bruker og har bestemte tillatelser.

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

OAuth 2.0

For applikasjoner med høyere sikkerhetskrav støtter vi autentiseringsflyten OAuth 2.0:

1. Autorisasjonsforespørsel: Send brukerne videre til autorisasjons-URL-en vår
2. Brukersamtykke: Brukeren godkjenner tilgang til kontoen sin
3. Autorisasjonskode: Serveren vår returnerer en autorisasjonskode
4. Utveksling av token: Bytt koden mot et tilgangstoken
5. API-forespørsler: Bruk tilgangstokenet til å nå beskyttede ressurser

JWT-tokener

Etter autentisering utsteder vi JWT-tokener som inneholder kodet informasjon om brukeren og tillatelsene vedkommende har.

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

Håndtering av økter

Økter er gyldige i 24 timer som standard. Slik fornyer du en økt:

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();

Beste praksis

1. Lagre aldri API-nøkler eller tokener i kode som kjører hos klienten
2. Bruk miljøvariabler for sensitive legitimasjonsdata
3. Implementer mekanismer for fornying av tokener i applikasjoner som kjører lenge
4. Sett fornuftige utløpstider for tokener
5. Bruk HTTPS for alle API-forespørsler