Microservices Summit 2020

API-Dokumentation mit OpenAPI

Workshop
Very-Early-Bird Bis 30. April anmelden und bis zu 400 € pro Ticket extra sparen! Jetzt anmelden
Infos
Dienstag, 9. Juni 2020
10:00 - 13: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.