OpenAPI
Die OpenAPI Specification (vormals Swagger Specification) ist eine Spezifikation zur Beschreibung von REST-konformen Programmierschnittstellen.[1] Gefördert wird die Spezifikation von der OpenAPI Initiative, zu deren Mitgliedern Unternehmen wie Atlassian, Google, IBM, Microsoft, PayPal und SAP zählen.[2] Die Initiative verfolgt die Vision, im Sinne einer vernetzten Welt ein offenes und Hersteller-neutrales Beschreibungsformat für API-Dienste bereitzustellen.[3] Das Projekt wird von der Linux Foundation unterstützt.[4]
Versionen
Die aktuelle Version der OpenAPI-Specification ist 3.0.2.[5][6]
Werkzeuge
Swagger bietet eine Sammlung von Open Source-Werkzeugen, um APIs zu entwickeln, die konform zur OpenAPI-Spezifikation sind:[7]
- Swagger Editor unterstützt beim Erzeugen der API-Definition
- Swagger Codegen generiert Server Stubs und Client SDKs
- Swagger UI erzeugt Dokumentation
Daneben existieren auch kostenpflichtige Werkzeuge:
- SwaggerHub für Kollaboration
- SwaggerHub Enterprise für Unternehmen, verfügbar in der Cloud oder On-Premises
- Swagger Inspector für Testzwecke
Auch für verschiedene Entwicklungsumgebungen existieren Erweiterungen zur Unterstützung von OpenAPI.[8][9]
Beispiele
- Swagger Petstore - fiktiver Server zur Demonstration von OpenAPI
- OpenAPI.NET - OpenAPI Dokumente in .NET
Weblinks
- Einstieg in OpenAPI v3: REST wird erwachsen
- OpenAPI Initiative
- OpenAPI Specification Repository
- Swagger Homepage
Einzelnachweise
- ↑ OpenAPI-Specification auf GitHub. Abgerufen am 30. Dezember 2019.
- ↑ Mitglieder der OpenAPI Initiative. Abgerufen am 30. Dezember 2019.
- ↑ Über die OpenAPI Initiative. Abgerufen am 30. Dezember 2019.
- ↑ Projekte der Linux Foundation. Abgerufen am 30. Dezember 2019.
- ↑ Releases der OpenAPI-Specification. Abgerufen am 30. Dezember 2019.
- ↑ OpenAPI-Initiative aktualisiert Schnittstellen-Spezifikation. 26. Juli 2017, abgerufen am 30. Dezember 2019.
- ↑ OpenAPI Open-Source Werkzeuge. Abgerufen am 30. Dezember 2019.
- ↑ OpenAPI-Editor für Visual Studio Code. Abgerufen am 30. Dezember 2019.
- ↑ OpenAPI-Tools für Eclipse. Abgerufen am 30. Dezember 2019.