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: Parameter, operationId, Antwortschemas und Berechtigungsumfang je Operation.
- API-Verzeichnis: Ö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.