Die OpenAPI Specification (OAS), früher bekannt als Swagger Specification, ist ein weltweit anerkannter Standard für die Definition und Dokumentation von RESTful-APIs. Eine openapi-Datei dient als sprachunabhängige Schnittstellenbeschreibung, die es sowohl Menschen als auch Maschinen ermöglicht, die Funktionen eines Webdienstes zu entdecken und zu verstehen, ohne Zugriff auf den zugrunde liegenden Quellcode zu benötigen. Diese Dateien sind typischerweise in YAML oder JSON strukturiert und enthalten detaillierte Informationen über API-Endpunkte, einschließlich verfügbarer Operationen, Eingabeparameter, Ausgabeformate, Authentifizierungsanforderungen und Lizenzinformationen. Durch die Verwendung dieses Formats können Entwickler eine 'API-first'-Designmethodik implementieren, die sicherstellt, dass die Schnittstelle klar definiert ist, bevor Code geschrieben wird. Dies erleichtert die automatisierte Generierung von interaktiver Dokumentation, clientseitigen Software Development Kits (SDKs), Server-Stubs und umfassenden Test-Suiten. Das Format wird von der OpenAPI Initiative, einem Konsortium unter der Linux Foundation, gepflegt und hat sich zum Industriestandard für die moderne Webentwicklung entwickelt, was eine nahtlose Integration zwischen unterschiedlichen Systemen ermöglicht und die Zusammenarbeit zwischen Frontend- und Backend-Entwicklungsteams verbessert.