Microservices Summit 2019

API-Dokumentation mit OpenAPI

Workshop
Early Bird Bis 7. November anmelden und bis zu 300 € sparen! Jetzt anmelden
Infos
Montag, 9. Dezember 2019
13:30 - 17:00

Der Erfolg einer API steht und fällt mit einer guten Dokumentation. Doch API-Anbieter haben die Qual der Wahl. Zahlreiche Werkzeuge konkurrieren um ihre Gunst. Im Bereich der Schnittstellenbeschreibungssprachen hat immerhin eine Konsolidierung stattgefunden: 

Das aus Swagger hervorgegangene OpenAPI wird zum Standard entwickelt. Doch während OpenAPI bzw. Swagger weit verbreitet ist und viele Anhänger hat, sind neben den vielen positiven Eigenschaften und Vorteilen auch einige Nachteile und Schwächen festzustellen. In diesem Workshop werden zunächst OpenAPI und eine Auswahl der zahlreich erhältlichen Tools vorgestellt. Im Anschluss werden die guten und weniger guten Seiten der Beschreibungssprache gegenübergestellt, Fallen aufgezeigt und dargestellt, auf welchen Teil der Tool-Unterstützung man vielleicht besser verzichten sollte.