API-Authentifizierung — JWT-Tokens // API

API-Authentifizierung — JWT-Tokens

Die API von OODA Intelligence authentifiziert sämtliche Anfragen über JWT (JSON Web Tokens).

Token anfordern

Senden Sie eine POST-Anfrage an den Authentifizierungs-Endpoint:

curl -X POST https://dashboard.oodaintel.com/api/v1/auth/token/ \
  -H "Content-Type: application/json" \
  -d '{"username": "ihr_benutzername", "password": "ihr_passwort"}'

Antwort

{
  "access": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
  "refresh": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..."
}

Token verwenden

Übergeben Sie das Access-Token bei jeder Anfrage im Header Authorization:

curl -X GET https://dashboard.oodaintel.com/api/v1/monitoring/ \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..."

Token erneuern

Ist das Access-Token abgelaufen, holen Sie mit dem Refresh-Token ein neues:

curl -X POST https://dashboard.oodaintel.com/api/v1/auth/token/refresh/ \
  -H "Content-Type: application/json" \
  -d '{"refresh": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..."}'

Rate Limiting

Wie viele Anfragen zulässig sind, hängt vom gebuchten Tarif ab:

Tarif Limit
Starter 100 Anfragen/Min.
Professional 500 Anfragen/Min.
Enterprise 2.000 Anfragen/Min.

Häufige Fehler

Code Beschreibung
401 Token ungültig oder abgelaufen
403 Keine Berechtigung für diese Ressource
429 Rate Limit überschritten