Oversigt over autentificering

Denne guide forklarer, hvordan du autentificerer dig mod vores API. Vi understøtter flere metoder:

API-nøgler

Den enkleste metode er at bruge API-nøgler. Hver API-nøgle er knyttet til en bestemt bruger og har bestemte rettigheder.

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

OAuth 2.0

Til mere sikkerhedskrævende applikationer understøtter vi OAuth 2.0-flowet:

1. Autorisationsanmodning: Send brugeren videre til vores autorisations-URL
2. Brugerens samtykke: Brugeren godkender adgang til sin konto
3. Autorisationskode: Vores server returnerer en autorisationskode
4. Ombytning af token: Byt koden til et adgangstoken
5. API-kald: Brug adgangstokenet til at tilgå beskyttede ressourcer

JWT-tokens

Efter autentificering udsteder vi JWT-tokens, som indeholder kodede oplysninger om brugeren og brugerens rettigheder.

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

Sessionshåndtering

Sessioner er som standard gyldige i 24 timer. Sådan fornyer du en session:

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

Bedste praksis

1. Gem aldrig API-nøgler eller tokens i kode, der kører hos klienten
2. Brug miljøvariabler til følsomme oplysninger
3. Byg fornyelse af tokens ind i applikationer, der kører længe
4. Sæt en passende udløbstid på dine tokens
5. Brug HTTPS til alle API-kald