DriverCard REST API¶

1. Zweck¶

Die DriverCard API stellt dieselben geparsten Fahrerkartendaten bereit wie die Desktopauswertung von FLEET Mira. Sie dient lokalen Integrationen und der integrierten Web-Wochenansicht. Archivoriginale werden nicht verändert.

Standardbasis: http://127.0.0.1:5055. Start/Stop/Browser/Log befinden sich unter System. Eine Bindung außerhalb Loopback benötigt vorgeschaltetes TLS/Authentifizierung und eine explizite Risikobewertung.

2. Zeit, Formate und Filter¶

Zeitstempel: ISO 8601 UTC;
Datum: YYYY-MM-DD;
Dauer: ganzzahlige Sekunden, sofern nicht anders angegeben;
Kartennummern: normalisierte Zeichenketten;
JSON: UTF-8;
Validierungsfehler: JSON mit error und verständlicher message.

Gemeinsame Parameter:

Parameter	Bedeutung
`import_id`	ID eines Parserimports
`archive_id`	stabile Tachodaten-Archiv-ID
`card_number`	exakte normalisierte Kartennummer
`date_from`, `date_to`	inklusiver UTC-Datumsbereich
`limit`, `offset`	begrenzte Paginierung, sofern unterstützt

3. Endpunkte¶

Methode/Pfad	Funktion
`GET /health`	Prozess-/Datenbankbereitschaft
`POST /api/drivercard/parse`	übergebene DDD parsen und Import speichern/wiederverwenden
`GET /api/drivercard/imports`	Fahrerkartenimporte listen
`GET /api/drivercard/time-summary`	Aktivitätssummen
`GET /api/drivercard/activities`	Aktivitätsintervalle
`GET /api/drivercard/events`	Ereignisse
`GET /api/drivercard/faults`	Störungen
`GET /api/drivercard/vehicles-used`	benutzte Fahrzeuge
`GET /api/drivercard/positions`	Positionsdatensätze
`GET /api/drivercard/day-overview`	aufbereitete Tagesdaten
`GET /api/drivercard/week-overview`	aufbereitete ISO-Wochendaten
`GET /api/drivercard/eu561/violations`	technische Vorprüfung VO 561/2006

4. Health¶

GET /health HTTP/1.1
Host: 127.0.0.1:5055

{"status":"ok","service":"drivercard-rest","database":"available"}

5. Fahrerkarte parsen¶

POST /api/drivercard/parse akzeptiert JSON. Der Web-Preload verwendet Base64; lokale Archivpfade erscheinen nicht in der Browser-URL.

{
  "file_name": "C_20250715_0615_Demo_1000000000000001.DDD",
  "content_base64": "BASE64_DATEN",
  "archive_id": "optionale-stabile-id"
}

Die Antwort nennt Import/Archiv, Fahrer-/Kartenmetadaten, Aktivitätszeitraum und Parserwarnungen. Binärinput, Signaturen und Zertifikate werden nicht zurückgegeben. Identische Inhalte sind per Hash idempotent.

6. Aktivitäten und Summen¶

GET /api/drivercard/activities?archive_id=ARCHIV_ID&date_from=2025-07-14&date_to=2025-07-20

Aktivitäten enthalten UTC-Beginn/-Ende, Code (DRIVING, WORK, AVAILABILITY, REST), Dauer, Karte, Crew und Slot. Tages-/Wochenendpunkte gruppieren dieselben Quellintervalle für die Darstellung und sind keine eigenen Nachweisdatensätze.

7. Ereignisse, Störungen, Fahrzeuge und Positionen¶

Ereignis-/Störungsantworten enthalten technischen Typ/Code, Beginn/Ende und bekannte Klartextbeschreibung. Unbekannte Erweiterungen bleiben mit Code sichtbar. Positionen enthalten Zeit, Breiten-/Längengrad, Quelle/Typ, Länder-/Regionscode und optional Kilometerstand.

8. Vorprüfung VO 561/2006¶

Der Endpunkt prüft nur die gewählte Datenbasis. Enthalten sind Fahrerübersicht, Verstöße, Hinweise, Regel-/Algorithmusversion und Datenlücken. Dies ist eine technische Vorprüfung, keine rechtliche/behördliche Würdigung. Nationale Ausnahmen, AETR und Art.-12-Umstände werden nicht automatisch entschieden.

9. HTTP-Status¶

Status	Bedeutung
`200`	erfolgreiche Abfrage/idempotenter Parse
`400`	fehlerhafte Payload/Filter
`404`	Archiv/Import nicht gefunden
`409`	Konflikt/Quarantäne bei vertrauenspflichtigem Vorgang
`413`	Payload zu groß
`422`	DDD-Inhalt nicht parsbar
`500`	unerwarteter Fehler; REST-Log korrelieren

10. Sicherheit und Betrieb¶

Loopback beibehalten, sofern kein geschütztes Gateway existiert.
DDD-Daten/lokale Pfade nicht in Querystrings schreiben.
REST-Logzugriff beschränken; Logs sind Englisch und enthalten keine DDD-Rohdaten/Secrets.
API vor Wartung über FLEET Mira stoppen.
API-Pfade und Feldnamen behalten trotz des Brandings von FLEET Mira ihre technische Kompatibilität.