API-First ist ein Designansatz, bei dem die Schnittstelle eines Systems vor seiner Implementierung definiert wird. APIs werden als Produkte verstanden, die explizit entworfen, dokumentiert, versioniert und gepflegt werden – häufig auf Basis offener Spezifikationen wie OpenAPI, AsyncAPI oder GraphQL Schemas.
In der Praxis startet die Entwicklung mit einer API-Definition, gegen die Frontend, Backend und externe Konsumenten parallel arbeiten können. Werkzeuge wie Mock-Server (z. B. Stoplight, Prism), SDK-Generatoren und Linter unterstützen den Lebenszyklus. Häufig wird API-First mit Contract-First-Ansätzen kombiniert.
Einsatzzweck ist die Entkopplung von Teams und Systemen, die Vermeidung impliziter Abhängigkeiten und die saubere Wiederverwendbarkeit von Funktionen. Insbesondere in Microservice- und Plattformarchitekturen ist API-First ein zentraler Hebel, um Verträge zwischen Komponenten klar und versioniert zu halten.
Der Begriff wurde durch das Wachstum öffentlicher APIs (Twitter, Stripe, Twilio) und durch Bewegungen wie das Pact-Framework (Consumer-Driven Contracts) ab Mitte der 2010er Jahre populär. Anbieter wie Postman, SwaggerHub und Stoplight haben den Markt für API-Tooling stark professionalisiert.
Berühmt ist Jeff Bezos' "API Mandate" bei Amazon (ca. 2002), in dem er forderte, dass alle Teams ihre Funktionen ausschließlich über Service-Schnittstellen anbieten. Aus dieser radikalen API-First-Kultur heraus entstanden später AWS und damit eine ganze Branche.