Autentiseringsöversikt

Den här guiden förklarar hur du autentiserar dig mot vårt API. Vi stödjer flera autentiseringsmetoder:

API-nycklar

Den enklaste autentiseringsmetoden är att använda API-nycklar. Varje API-nyckel hör till en viss användare och har specifika behörigheter.

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

OAuth 2.0

För applikationer med högre säkerhetskrav stödjer vi autentiseringsflödet OAuth 2.0:

1. Auktoriseringsbegäran: Skicka användaren vidare till vår auktoriserings-URL
2. Användarens samtycke: Användaren godkänner åtkomst till sitt konto
3. Auktoriseringskod: Vår server returnerar en auktoriseringskod
4. Tokenutbyte: Byt koden mot en åtkomsttoken
5. API-anrop: Använd åtkomsttoken för att nå skyddade resurser

JWT-tokens

Efter autentiseringen utfärdar vi JWT-tokens som innehåller kodad information om användaren och dennes behörigheter.

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

Sessionshantering

Sessioner gäller i 24 timmar som standard. Så här förnyar 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();

Bästa praxis

1. Lagra aldrig API-nycklar eller tokens i kod som körs hos klienten
2. Använd miljövariabler för känsliga uppgifter
3. Bygg in mekanismer för att förnya token i applikationer som körs länge
4. Sätt lämpliga giltighetstider för tokens
5. Använd HTTPS för alla API-anrop