/v1Die Klammer im Pfad.
v2 gibt es nur bei einem Paradigmenbruch.Bodo-Version: 2026-11-01Datumsversion im Header. Ohne Header gilt der Pin des Schlüssels, jede Antwort nennt die angewandte Version.
Bodo-Preview: trueEin beweglicher Kanal für neue Operationen. Brüche sind dort erlaubt und stehen im Changelog. Keine Produktionsgrundlage, nicht pinnbar.
Lebenslauf der Versionen
Gezeichnet aus der Versions-Registry der API. Eine abgelöste Version läuft ab Erscheinen ihrer Nachfolgerin noch 12 Monate, Brownouts liegen in den letzten 6 Wochen davor.
Welche Version gilt für meinen Aufruf?
| Reihenfolge | Quelle | Beispiel |
|---|---|---|
| 1 | Header im Request | Bodo-Version: 2026-11-01 |
| 2 | Pin des Schlüssels (beim Anlegen die aktuelle Stable) | versionPin: 2026-11-01 |
| – | Org-Default gibt es nicht | bewusst, damit kein versteckter Zustand entsteht |
nur mit neuer VersionBruch
- Feld oder Operation entfernt oder umbenannt
- Typwechsel eines Felds
- neues Pflichtfeld im Request, engere Validierung
- geänderter Default, entfernter Enum-Wert
- geänderter
code, geänderte Semantik
sofort live, im ChangelogKein Bruch
- neues optionales Feld im Request
- neues Feld in der Antwort
- neuer Enum-Wert in der Antwort (
x-extensible-enum) - neue Operation
- neuer
codefür eine neue Bedingung
Tolerant Reader:
Unbekannte Felder und Enum-Werte ignorieren, nie darauf scheitern.- Bruchversionen: höchstens 2 pro Jahr
- Supportfenster: 12 Monate