Was ist der Unterschied zwischen OpenAPI und Swagger? Welche Version verwenden Sie?

OpenAPI ist eine Spezifikation zur Beschreibung von RESTful-APIs, die es ermöglicht, die Schnittstellen von Webdiensten zu standardisieren. Swagger war ursprünglich ein Werkzeug und ein Ökosystem für die Arbeit mit APIs, einschließlich der Generierung von Dokumentation, Client-SDKs und Server-Stub-Generatoren.

Im Jahr 2016 wurde die Swagger-Spezifikation in die OpenAPI Specification (OAS) umbenannt und unter der Schirmherrschaft der Linux Foundation an die OpenAPI-Initiative übertragen. Heute ist OpenAPI ein Standard, und Swagger ist eine Sammlung von Werkzeugen, die diesen Standard unterstützen.

In der Regel wird die neueste stabile Version der OpenAPI Specification verwendet, die im Jahr 2024 OpenAPI 3.1.x ist, da sie eine flexiblere Beschreibung ermöglicht, einschließlich vollständiger Kompatibilität mit JSON Schema.

Beispiel für die Verwendung von OpenAPI 3.1: