Versionierung & Changelog

Major-Version in der URL, additive Änderungen innerhalb einer Version, angekündigte Abkündigungen.

Versionsschema

Die Major-Version steht in der URL: …/api/partner/v1/…. Innerhalb einer Major-Version ändert sich die API nur additiv:

• neue Endpoints, neue optionale Request-Felder,
• neue Felder in Responses und Webhook-Payloads,
• neue Event-Typen, neue Fehler-Codes.

Bauen Sie Ihre Integration tolerant: unbekannte Felder in Responses und Payloads ignorieren, unbekannte Event-Typen bestätigen und überspringen. Dann bleiben additive Änderungen für Sie unterbrechungsfrei.

Nicht abwärtskompatible Änderungen (Felder entfernen/umbenennen, Semantik ändern, Pflichtfelder hinzufügen) erscheinen nur in einer neuen Major-Version (/v2).

Deprecation-Policy

• Abkündigungen (einzelner Felder, Endpoints oder einer ganzen Major-Version) werden im Changelog auf dieser Seite angekündigt.
• Abgekündigte Bestandteile bleiben während einer Übergangsfrist funktionsfähig; die Frist wird mit der Ankündigung genannt.
• Direkt betroffene API-Partner werden zusätzlich von Hemostat informiert.

Changelog

1.0.0 — initiales Release

Erste Version der Partner-API: Aufträge (anlegen, auflisten, Detail, stornieren, Event-Historie), Standorte, Webhooks mit signierten Zustellungen, /ping.