Das Swagger-Dateiformat, das heute offiziell als OpenAPI Specification (OAS) bekannt ist, ist eine maschinenlesbare Schnittstellenbeschreibungssprache zum Beschreiben, Erstellen, Konsumieren und Visualisieren von RESTful-Webdiensten. Ursprünglich von SmartBear Software entwickelt, ermöglicht es Entwicklern, die gesamte Struktur einer API zu definieren, einschließlich verfügbarer Endpunkte, Operationsparameter, Authentifizierungsmethoden und Antwort-Schemata. Durch die Verwendung eines standardisierten Formats ermöglichen Swagger-Dateien die automatisierte Dokumentationserstellung, die Erstellung von Client-Bibliotheken in verschiedenen Programmiersprachen sowie automatisierte Tests. Das Format wird typischerweise in JSON oder YAML geschrieben, was es sowohl für Menschen lesbar als auch für Maschinen leicht interpretierbar macht. Es dient als Blaupause für die API und stellt sicher, dass sowohl Frontend- als auch Backend-Teams ein klares, gemeinsames Verständnis über das Verhalten des Dienstes haben. Dies reduziert Integrationsfehler und beschleunigt den Entwicklungslebenszyklus durch einen „Contract-First“-Ansatz beim API-Design. Es ist in der Softwareindustrie als Standard für die Dokumentation und das Design von RESTful-APIs weit verbreitet und wird durch ein riesiges Ökosystem an Werkzeugen für Tests, Mocking und Deployment unterstützt.