Übersicht

Die API deckt Anmeldung, MFA, Passkeys, App-Kopplung, Geräte, Nutzer, Fahrzeuge, Fahrten, Tracking, Statistiken, Import/Export, Geocoding und Administration ab. Alle Seiten in diesem Bereich werden aus der OpenAPI-Spezifikation generiert.

Basis-URLCopy Anchor Link

https://deine-domain.example/api/v1

AuthentifizierungCopy Anchor Link

Geschützte Endpunkte erwarten einen Access-Token:

Authorization: Bearer <accessToken>

Anmelden mit POST /auth/login, erneuern mit POST /auth/refresh. Refresh-Tokens werden rotiert – speichere immer den zuletzt erhaltenen.

POST /api/v1/auth/login
Content-Type: application/json

{
  "identifier": "admin@example.com",
  "password": "dein-passwort",
  "deviceName": "Android",
  "platform": "android",
  "appVersion": "1.0.0"
}

Swagger UI in der eigenen InstanzCopy Anchor Link

Mit SHOW_API_UI=true liefert der Server zusätzlich /api, /api/docs und /api/v1/openapi.yml aus.