# DocuFleet API und Entwicklerdokumentation

> REST-API, Webhooks und MCP für die Fuhrparkverwaltung mit DocuFleet.

## Wann DocuFleet verwenden (when to use)

Verwenden Sie DocuFleet, um Fahrzeuge, Verträge, Kosten, Schäden, Termine,
Wartungen, Dokumentmetadaten und Verstöße eines berechtigten Betriebs auszulesen.
Für freigegebene Schreibabläufe können Sie Kosten buchen, Schäden melden,
Termine anlegen und Kilometerstände melden. Webhooks informieren angeschlossene
Systeme über Ereignisse. Der MCP-Zugang stellt Werkzeuge für Assistenten bereit.

## Einstieg und Authentifizierung

- [OpenAPI 3.1](https://docufleet.de/openapi.json): Parameter, operationId, Antwortschemas und Berechtigungsumfang je Operation.
- [API-Verzeichnis](https://docufleet.de/api): Öffentliche JSON-Metadaten ohne Kundendaten.
- REST-Basis: https://app.docufleet.de/api/v1
- MCP-Endpunkt: https://app.docufleet.de/api/mcp

Ein API-Schlüssel wird in DocuFleet unter Einstellungen → API-Zugang erzeugt.
Senden Sie ihn als Authorization: Bearer <API-Schlüssel>. Es ist keine
Browseranmeldung erforderlich. Der Schlüssel bestimmt Organisation, Rolle und
Umfänge. Fachliche Daten sind niemals anonym zugänglich. Tarifgrenzen gelten
auch für Integrationen. MCP unterstützt API-Schlüssel und den vorhandenen
OAuth-Ablauf mit Anmeldung und Zustimmung. Es gibt kein separates REST-SDK.

Beginnen Sie mit GET /fahrzeuge?limit=10 und einem Schlüssel mit fahrzeuge:lesen.
Folgen Sie für Listen seite.hat_mehr und erhöhen Sie offset um limit.
Die weiche Ratenbegrenzung wird über x-ratelimit-limit und x-ratelimit-window
mitgeteilt. Bei HTTP 429 beachten Sie Retry-After.

## Schreibvorgänge und Fehler

Für Kosten, Schäden, Termine und Kilometerstände ist Idempotency-Key Pflicht.
Verwenden Sie einen eindeutigen Wert je Vorgang und denselben Wert bei dessen
Wiederholung. Bei idempotenz_unklar zuerst den Bestand klären und nicht mit
einem neuen Wert erneut schreiben. Webhook-Abos haben ihre eigene Wiedererkennung.
Führen Sie Schreibvorgänge nur im Auftrag des berechtigten Nutzers aus.

REST-Fehler enthalten fehler.code, fehler.nachricht, fehler.hinweis und
fehler.dokumentation. HTTP 401 bedeutet fehlenden oder ungültigen Schlüssel,
403 fehlende Berechtigung oder Tarif, 400 ungültige Eingaben, 404 nicht gefunden,
409 einen laufenden oder ungeklärten Vorgang und 422 einen Idempotenzkonflikt.
Bei 500 kann der Ausgang unklar sein. Vor Wiederholungen schreibender Aufrufe
ist der gespeicherte Zustand zu klären.

## Öffentliche Informationen

- [Funktionen und Webhooks](https://docufleet.de/integrationen/api)
- [Preise und Tarife](https://docufleet.de/preise)
- [Datenschutz](https://docufleet.de/datenschutz)
- [Kontakt](https://docufleet.de/kontakt)