#Versionen und Änderungen

Auf dieser Seite

Was ohne neue Version kommt
Was eine neue Version braucht
Wie wir ankündigen
Bisherige Webhook-Köpfe

Die Schnittstelle trägt ihre Version im Pfad: /api/v1. Innerhalb von v1 ändern wir nichts so, dass eine korrekt gebaute Anbindung bricht. Den Stand innerhalb von v1 nennt apiVersion (derzeit 2026-09-01) — in GET /me und in jeder Webhook-Nachricht.

#Was ohne neue Version kommt

Diese Änderungen sind jederzeit möglich — Ihr System muss sie vertragen:

neue Endpunkte,
neue optionale Felder in Anfragen,
neue Felder in Antworten und Webhook-Nachrichten,
neue Webhook-Ereignisse (sie kommen nur, wenn Sie sie abonnieren),
neue Werte in Aufzählungen, etwa ein neuer Auftragsstatus,
neue Fehlercodes,
andere Texte in message (und in hinweis der bisherigen Schnittstelle).

Daraus folgt für Ihre Anbindung:

Wichtig

Unbekannte Felder übergehen, unbekannte Status als „in Arbeit“ behandeln, Fehler nach error.code und HTTP-Status auswerten — nie nach dem Wortlaut von message.

#Was eine neue Version braucht

Alles, was eine korrekte Anbindung bricht: ein Feld entfällt oder ändert seine Bedeutung, ein Pflichtfeld kommt hinzu, ein Endpunkt verschwindet, das Format der Signatur ändert sich. Das kommt unter einem neuen Pfad (/api/v2). Die alte Version bleibt für eine Übergangszeit erreichbar, die wir vorher ankündigen.

#Wie wir ankündigen

Jede Änderung steht im Änderungsprotokoll — mit Datum und was sie für Sie heißt.
Änderungen, die Handlungsbedarf auslösen, schreiben wir zusätzlich den technischen Ansprechpartnern.
Die OpenAPI-Beschreibung entsteht aus dem Code und ist immer auf dem Stand des Servers.

#Bisherige Webhook-Köpfe

X-Webhook-Signature und X-Webhook-Delivery-ID stammen aus der ersten Fassung der Webhooks. Endpunkte im bisherigen Format bekommen sie weiter, damit keine bestehende Anbindung bricht. Endpunkte der API v1 bekommen nur X-LogiCar-Signature und X-LogiCar-Delivery.