API-first
Daten, mögliche Aktionen, Fehler und Zugriffsrechte werden vor oder gemeinsam mit den Oberflächen beschrieben. Das erleichtert Abstimmung und automatisierte Tests.
API-first, API-only und Backend-for-Frontend:
was bedeuten diese Ansätze?
Eine Programmierschnittstelle verbindet Daten und Regeln mit Websites, Apps oder anderen Programmen. Wie allgemein und dauerhaft sie ausgelegt werden muss, hängt von ihren Nutzern ab.
Dein Vorhaben besprechenDie wichtigsten Gedanken.
API-first plant die Schnittstelle früh. API-only bietet ausschließlich eine Schnittstelle an. Ein Backend-for-Frontend bereitet Daten gezielt für eine bestimmte Oberfläche auf.
- Klare Vereinbarungen für Schnittstellen
- Mehrere Anwendungen möglich
- Versionierung und Kompatibilität
- REST, GraphQL oder Ereignisse
- Öffentliche und interne Schnittstellen trennen
- Gezielte Aufbereitung pro Oberfläche
API-only
Das Produkt besteht hauptsächlich aus einer Schnittstelle für andere Programme. Dokumentation, verlässliche Versionen, getrennte Kundendaten und Schutz vor Missbrauch werden dann besonders wichtig.
Backend-for-Frontend
Eine eigene Zwischenschicht kann Daten genau für eine Website oder App aufbereiten. Das vereinfacht die Oberfläche, darf gemeinsame Geschäftsregeln aber nicht widersprüchlich doppeln.
Die Form folgt den Nutzern der Schnittstelle
REST ist häufig unkompliziert, GraphQL kann bei vielen unterschiedlichen Datenansichten helfen, Webhooks melden Änderungen und Warteschlangen entkoppeln Hintergrundarbeit. Mehrere Muster können nebeneinander sinnvoll sein.
Weiterdenken.
Mehr Grundlagen für gute Entscheidungen.