Alle Begriffe
Glossar
API First
Die Schnittstelle wird zuerst entworfen und abgestimmt, danach entstehen Umsetzung und Oberfläche dagegen.
Der Vorteil ist, dass mehrere Teams parallel arbeiten können: Wer die Schnittstelle kennt, kann die Oberfläche bauen, bevor die Logik fertig ist.
Der zweite Vorteil zeigt sich bei Ablösungen. Eine stabile Schnittstelle erlaubt, das dahinterliegende System auszutauschen, ohne alle Aufrufer anzufassen.
Woran Sie es erkennen
- Oberfläche und Backend werden von verschiedenen Teams gebaut.
- Es gibt mehrere Aufrufer derselben Funktion, etwa Web und App.
- Ein Bestandssystem soll später ausgetauscht werden.
Häufig gefragt
Was gehört in eine Schnittstellenbeschreibung, bevor entwickelt wird?
Die Ressourcen mit ihren Feldern, die möglichen Fehler mit Statuscodes, das Verhalten bei Blätterung und Filterung, und die Frage, wie Versionen behandelt werden. Alles andere darf offen bleiben, diese vier nicht.