Authentifizierung

Authentifizierung

Samdock verwendet JWT (JSON Web Token) basierte Authentifizierung. Alle API-Anfragen (außer Login) erfordern einen gültigen Zugriffstoken.

Login

Um einen Zugriffstoken zu erhalten, senden Sie eine POST-Anfrage an den Auth-Service:

curl -X POST https://api.samdock.com/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@example.com",
    "password": "ihr-passwort"
  }'

Die Antwort enthält einen Zugriffstoken und einen Aktualisierungstoken:

{
  "accessToken": "eyJhbGciOiJSUzI1NiIs...",
  "refreshToken": "eyJhbGciOiJSUzI1NiIs..."
}

Token verwenden

Fügen Sie den Zugriffstoken in den Authorization-Header aller nachfolgenden Anfragen ein:

curl https://api.samdock.com/contacts \
  -H "Authorization: Bearer eyJhbGciOiJSUzI1NiIs..."

Token erneuern

Zugriffstokens laufen nach einer bestimmten Zeit ab. Verwenden Sie den Aktualisierungstoken, um einen neuen Zugriffstoken zu erhalten:

curl -X POST https://api.samdock.com/auth/refresh \
  -H "Content-Type: application/json" \
  -d '{
    "refreshToken": "eyJhbGciOiJSUzI1NiIs..."
  }'

Token widerrufen

Zum Abmelden oder Ungültigmachen eines Tokens:

curl -X POST https://api.samdock.com/auth/revoke \
  -H "Authorization: Bearer eyJhbGciOiJSUzI1NiIs..."

Fehlerantworten

Die vollständige Auth-API-Referenz finden Sie unter Auth API-Endpunkte.