API-first architecture
Konzept
Eine API-First-Architektur entwirft Geschäftsfähigkeiten als stabile, aufrufbare APIs, noch bevor eine Benutzeroberfläche entsteht, sodass Benutzeroberflächen, Workflow-Engines und KI-Agenten dieselben Operationen nutzen.
Ebenfalls besprochen
In der Folge zu API-first architecture geht es auch um Computer-Using Agent (CUA), Foundry Agent Service, Service account, Agent observability, Microsoft Agent 365 und Software as a service (SaaS).
Beschreibung
API-first-Architektur ist ein Entwurfsansatz, bei dem Geschäftsfunktionen als stabile, aufrufbare APIs definiert werden, bevor eine Benutzeroberfläche gebaut wird. Dieselben Operationen werden anschließend von Benutzeroberflächen, Workflow-Engines und KI-Agenten genutzt, anstatt dass jeder Client die Logik über einen eigenen Weg erreicht. In diesem Modell gilt die API als Produktentscheidung und nicht als Nebenprodukt des Codes, da externe Entwickler, Partner und KI-Agenten darauf aufbauen sollen.
Ein zentrales Element der API-first-Entwicklung ist der API-Vertrag. Laut dem Microsoft-Artikel zur API-first-Entwicklung beschreibt der Vertrag Endpunkte, Anfrage- und Antwortdaten sowie erwartete Fehler, und er wird vor der Implementierung oder der Benutzeroberfläche verfasst. Der Vertrag wird üblicherweise in einem maschinenlesbaren Format ausgedrückt, meist in OpenAPI. Sobald der Vertrag genehmigt ist, implementieren Backend-Teams ihn, während Front-End- und Mobile-Teams gegen aus ihm generierte Mocks entwickeln. Dokumentation, SDKs und Tests lassen sich aus derselben Quelle erzeugen, was die verschiedenen Artefakte miteinander konsistent hält.
Der Ansatz wird häufig dem Code-first-Ansatz gegenübergestellt. Bei einer Code-first-Vorgehensweise entsteht die API aus bestehendem Code, wodurch interne Details in die öffentliche Schnittstelle gelangen können. API-first kehrt diese Reihenfolge um: Die Schnittstelle wird bewusst entworfen, und der Code wird so geschrieben, dass er sie erfüllt. Die Microsoft-Seite nennt auch Abwägungen. Vertragsorientierte Arbeit erfordert im Voraus zusätzlichen Prüfaufwand, und ein Code-first-Ansatz kann für ein frühes internes Werkzeug vertretbar sein, bei dem es nur wenige Nutzer gibt und sich die Schnittstelle voraussichtlich schnell ändert. Die Seite ist ein Herstellerartikel und enthält Azure-spezifische Inhalte.
Versionierung ist ein wesentlicher Bestandteil der Praxis. Da Konsumenten vom Vertrag abhängen, wird Versionierung als Vereinbarung mit ihnen behandelt: Additive Änderungen gelten innerhalb einer Version als unbedenklich, während brechende Änderungen eine neue Version erfordern. Die Abkündigung älterer Versionen kann über einen Sunset-Header signalisiert werden, sodass Konsumenten einen klar definierten Weg zur Migration erhalten statt einer abrupten Störung.
Eine weitere Eigenschaft besteht darin, dass eine einzige API über ein gemeinsames Gateway Web-, Mobile-, Partner- und Agenten-Clients bedienen kann. Authentifizierung und Ratenbegrenzung gelten dann einheitlich für alle Aufrufer, und die Geschäftslogik wird nicht über getrennte Kanäle hinweg dupliziert. Deshalb ist das Konzept für agentengesteuerte Systeme relevant, in denen Softwareagenten vorhersehbare, dokumentierte Operationen aufrufen müssen.
Die M365.FM-Episode "Computer-Using Agents: How CUA Could Transform SaaS" verbindet API-first-Architektur mit Agenten-Ökosystemen. Die Episode sagt, dass Agenten-Ökosysteme gedeihen, wenn eine API-first-Architektur eingeführt wird, weil sie Agenten, Systeme und Workflows klar und vorhersehbar verbinden kann. Sie beschreibt stabile APIs als Rückgrat intelligenter Systeme und sagt, Entwickler könnten sich darauf verlassen, um ohne Angst vor Störungen zu innovieren. Außerdem nennt sie Erweiterbarkeit als Vorteil, der Organisationen hilft, sich wandelnden Anforderungen anzupassen. In diesem Rahmen steht API-first-Design neben Investitionen in Workflows, die Agenten erstellen, automatisieren und skalieren können.
Zu den typischen Entscheidungen rund um API-first-Architektur gehört, welche Funktionen als APIs bereitgestellt werden, welches Vertragsformat verwendet wird, wie Änderungen versioniert und abgekündigt werden und wo ein Gateway für gemeinsame Authentifizierung und Ratenbegrenzung platziert wird. Teams wägen außerdem den Vorab-Aufwand der Vertragsprüfung gegen die Vorteile paralleler Front-End- und Backend-Arbeit sowie generierter Dokumentation und Tests ab.
Überblick, mit KI aus M365.FM-Folgen und den Fakten dieser Seite zusammengestellt. Du kannst ihn unten über „Bearbeiten“ verbessern.
| Typ | Konzept |
|---|---|
| Art | Architektur |
Häufige Fragen
Mit KI markierte Fragen wurden mit KI aus den Fakten dieser Seite geschrieben.
Was bedeutet API-first-Architektur? (KI)
Es bedeutet, Geschäftsfunktionen als stabile, aufrufbare APIs zu entwerfen, bevor eine Benutzeroberfläche entsteht, sodass Benutzeroberflächen, Workflow-Engines und KI-Agenten alle dieselben Operationen nutzen. Der API-Vertrag wird zuerst definiert, und die Implementierung folgt.
Worin unterscheidet sich API-first von Code-first? (KI)
Bei der Code-first-Entwicklung ist die API ein Nebenprodukt des bestehenden Codes und kann interne Details preisgeben. Bei der API-first-Entwicklung werden der Vertrag, üblicherweise in OpenAPI geschrieben, entworfen und genehmigt, bevor Implementierung oder Benutzeroberfläche entstehen.
Warum ist API-first für KI-Agenten relevant? (KI)
Die Episode "Computer-Using Agents: How CUA Could Transform SaaS" sagt, stabile APIs bilden das Rückgrat intelligenter Systeme und ermöglichen es, Agenten, Systeme und Workflows klar und vorhersehbar zu verbinden. Eine einzige API hinter einem Gateway kann zudem Agenten-Clients neben Web- und Mobile-Clients bedienen.
Community-Wiki
Oben die Kurzinfo, unten das Wissen der Community: ergänze praktische Tipps, Beispiele oder Korrekturen. Neue Beiträge werden zuerst geprüft, bewährte Mitglieder veröffentlichen direkt.
Experten und Firmen zu diesem Thema
Dieses Thema hat noch niemand im Profil angegeben. Trag es in deinem Profil ein.
Gepflegt von Mirko Peters (Microsoft MVP) · Zuletzt aktualisiert: