Roosevelt Docs

Authenticatie

API authenticatie en autorisatie

Authenticatie

De Roosevelt API gebruikt token-based authenticatie via Clerk.

Bearer Token

Alle API requests vereisen een Authorization header:

curl -H "Authorization: Bearer <clerk-session-token>" \
  https://api.roosevelt.dev/api/v1/resource

Token Ophalen

import { useAuth } from '@clerk/nextjs'
 
const { getToken } = useAuth()
const token = await getToken()
 
const response = await fetch('/api/v1/resource', {
  headers: {
    Authorization: `Bearer ${token}`,
  },
})

Error Responses

StatusCodeBetekenis
401UNAUTHORIZEDGeen of ongeldig token
403FORBIDDENOnvoldoende rechten
429RATE_LIMITTe veel requests

Voorbeeld error response

{
  "success": false,
  "error": "UNAUTHORIZED",
  "message": "Valid authentication token required"
}

API Response Format

Alle endpoints volgen hetzelfde response patroon:

interface ApiResponse<T> {
  success: boolean
  data?: T
  error?: string
  meta?: {
    total: number
    page: number
    limit: number
  }
}

On this page