REST-API

DGT-Abfragen für Bestände mit Tausenden Fahrzeugen.

Integrieren Sie Abfragen für Ihren Bestand oder Fuhrpark über Kennzeichenstapel. Verfolgen Sie jede Anfrage, rufen Sie die JSON-Übersicht nach der Analyse ab und laden Sie das offizielle PDF herunter, sobald es verfügbar ist.

API-Zugang anfordern

Eine Schnittstelle für Ihre Integration

Firmenzugang

Bearer-Tokens mit festgelegten Berechtigungen und Widerruf über das Firmenportal.

JSON-Übersicht und PDF

Die Berichtsdetails liefern nach der Analyse 17 Fahrzeugfelder und Zugriff auf das verfügbare PDF. Während der Verarbeitung können Ergebnisse null sein.

Asynchrone Stapel

POST /reports/batch nimmt ein plates-Array entgegen und liefert 202. Jeder Stapel wird innerhalb des konfigurierten Limits im Hintergrund verarbeitet.

Idempotenz und Status

Idempotency-Key kennzeichnet Ihre Anfragen. Status, Fortschritt und Ergebnis rufen Sie anschließend per GET ab.

/v1

Wichtigste Endpunkte

Versionierte REST-API unter /api/v1 mit Token-Authentifizierung, Limits und dokumentiertem Fehlermodell.

Authentifizierung

Ein Bearer-Token gehört zu einem Unternehmen; Berechtigungen begrenzen die verfügbaren Aktionen. Sie können eine API-Zugangsberechtigung im Portal widerrufen, ohne andere zu beeinflussen.

Authorization: Bearer <token>

reports	Einen DGT-Bericht bestellen, Berichte auflisten, einen abrufen, sein PDF herunterladen.
reports/batch	Viele Kennzeichen auf einmal einreichen; die Last läuft losgelöst von der Anfrage.
usage	Guthaben, Tarif und das Buchungsjournal.
vehicles	Ihre Flotte – optional, da das Bestellen eines Berichts sein Fahrzeug registriert.
locations · departments · subsidiaries · batches	Wie die Flotte organisiert ist.

Beispiel einer Berichtsanfrage

curl -X POST https://veriflota.es/api/v1/reports \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"plate":"1234BCD"}'

Erste Antwort: Verarbeitung ausstehend

{
  "id": "01M0ANQ0DFADGVM5PV26ZYV3YX",
  "plate": "1234BCD",
  "status": "placed",
  "progress": "queued",
  "requester": { "type": "api_credential", "name": null },
  "placedAt": "2026-08-19T09:14:22+00:00",
  "settledAt": null,
  "outcome": { "returnCode": null, "documentAvailable": false },
  "vehicle": null
}

Fehlermodell

Konsistente JSON-Fehler mit stabilen maschinenlesbaren Codes, die aus den internen Ausnahmen abgeleitet werden.

{
  "error": {
    "code": "insufficient_report_balance",
    "message": "Not enough reports left on this account.",
    "details": { "needed": 5, "available": 2, "shortfall": 3 }
  }
}

unauthenticatedinsufficient_scopevalidation_failedinsufficient_report_balancereport_already_in_flightidempotency_key_reusedrate_limited

Vollständige API-Referenz

Jeder Endpunkt, jeder Request-Body, jedes Antwortfeld und jeder Fehlercode – generiert aus der API selbst. Melden Sie sich an, um sie zu lesen; fordern Sie zuerst Zugang an, falls Sie noch kein Konto haben.

Referenz öffnen

Bereit zur Integration?

Erzählen Sie uns von Ihrem Abfragevolumen und Ihrer geplanten Integration. Wir helfen Ihnen, den Zugang für Ihr Unternehmen vorzubereiten.

API-Zugang anfordern