Zum Hauptinhalt springen

API Governance

API-Deprecation-Richtlinie.

Audact gewährt seinen Kunden einen Vorlauf von mindestens 12 Monaten, bevor ein /apis/*-Endpunkt entfernt oder verändert wird. Das gilt für öffentliche REST-Endpunkte, Webhook-Payloads und die stabile SDK-Oberfläche.

1. Benachrichtigungswege

  • Deprecation-Ankündigung im öffentlichen Changelog
  • HTTP-Response-Header Deprecation und Sunset (RFC 8594)
  • E-Mail-Benachrichtigung an den Admin-Kontakt des Kunden und den hinterlegten technischen Kontakt
  • Banner im Plattform-Dashboard

2. Parallelbetrieb

Alter und neuer Endpunkt laufen über den gesamten Zeitraum von 12 Monaten parallel; die Migrationsdokumentation wird am selben Tag veröffentlicht, an dem die Deprecation-Ankündigung erfolgt. Kompatibilitäts-Shims können das Zeitfenster bei Breaking Changes mit regulatorischen Auswirkungen verlängern.

3. Sicherheitsausnahmen

Muss ein Endpunkt aufgrund eines Sicherheits- oder Compliance-Mangels schneller entfernt werden, gewährt Audact die kürzeste vertretbare Vorlaufzeit (Ziel ≥ 30 Tage), veröffentlicht ein Advisory nach CVE-Art und unterstützt betroffene Kunden ohne zusätzliche Kosten bei der Migration.