Was bedeutet API-Lifecycle?
Eine Schnittstelle wird entworfen, umgesetzt, getestet und bereitgestellt. Danach folgen Betrieb, Änderungen und gegebenenfalls ihre Ablösung. Für jede Phase braucht es verantwortliche Personen und nachvollziehbare Entscheidungen.
Besonders wichtig ist der Übergang zu neuen Versionen. Nutzende Anwendungen müssen rechtzeitig erfahren, was sich ändert und wann sie umstellen sollen. Das gilt auch für ausschließlich interne Schnittstellen.
So sieht das in der Praxis aus
Beispiel: Eine neue Rechnungs-API durchläuft Vertragsprüfung, Freigabe, Überwachung und später eine angekündigte Ablösung.
Häufige Fragen
Wer sollte für eine API verantwortlich sein?
Eine benannte Stelle sollte Vertrag, Betrieb und Änderungen koordinieren. Fachliche und technische Zuständigkeiten können verteilt sein, müssen aber für Nutzer erreichbar bleiben.
Wann kann eine alte API abgeschaltet werden?
Wenn die angekündigten Bedingungen erfüllt sind und bekannte Nutzer umstellen konnten. Nutzungsdaten helfen zu prüfen, ob noch Anfragen bei der alten Version eingehen.
Welche Unterlagen müssen im Betrieb aktuell bleiben?
Insbesondere Schnittstellenbeschreibung, Zugangsregeln, Änderungshinweise und Ansprechpartner. Auch bekannte Einschränkungen und der geplante Umgang mit Störungen sollten nachvollziehbar sein.