API-Versionierungsrechner
Berechnen Sie gleichzeitige API-Versionen und den Wartungskostenmultiplikator aus aktiven Versionen, Abkündigungszeitraum und Veröffentlichungsfrequenz.
So verwenden Sie den API-Versionierungsrechner
- Geben Sie die Anzahl der aktuell aktiven API-Versionen ein.
- Geben Sie den Abkündigungszeitraum in Monaten ein.
- Geben Sie die Veröffentlichungsfrequenz in Monaten ein.
- Klicken Sie auf Berechnen, um gleichzeitige Versionen und Wartungskosten zu sehen.
Anwendungsfälle
- •Planung der API-Versionierungsstrategie für Plattform-APIs.
- •Schätzung der Wartungskosten langer Abkündigungszeiträume.
- •Aufbau des Geschäftsfalls für kürzere Unterstützungszeiträume.
- •Gestaltung von API-Lebenszyklusrichtlinien für Entwicklerplattformen.
Formel
Gleichzeitige Versionen = ceil(Abkündigungszeitraum / Veröffentlichungsfrequenz) + 1. Wartungsmultiplikator = gleichzeitige / aktive Versionen.
Häufig gestellte Fragen
Wie lange sollte ich alte API-Versionen unterstützen?
Der Branchenstandard sieht eine Abkündigungsfrist von 6–12 Monaten vor. Große APIs (Stripe, Twilio) unterstützen Versionen für 2+ Jahre.
Wie kommuniziere ich die Abkündigung von Versionen?
Verwenden Sie den Sunset-HTTP-Header, Abkündigungshinweise in der Dokumentation, E-Mail-Benachrichtigungen an API-Nutzer und Ablaufdaten.
URL- vs. Header-Versionierung?
URL-Versionierung (/v1/resource) ist sichtbarer und cachefähiger. Header-Versionierung (Accept: application/v2+json) ist eleganter, aber weniger auffindbar.