API Conference 2018
The Conference for Web APIs, API Design & Management
September 24 - 26, 2018 in Berlin

API-Dokumentation mit OpenAPI – The Good, the Bad and the Ugly

Session
Infos
Tuesday, September 25 2018
11:15 - 12:15
Room:
Salon 4

Der Erfolg einer API steht und fällt mit einer guten Dokumentation. Doch API-Betreiber haben die Qual der Wahl: Zahlreiche Werkzeuge konkurrieren um ihre Gunst. Im Bereich der Schnittstellenbeschreibungssprachen ist nun eine gewisse Konsolidierung im Gange: Das aus Swagger hervorgegangene OpenAPI soll zum Standard entwickelt werden. Doch während Swagger/OpenAPI 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 Vortrag 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 Toolunterstützung man vielleicht besser verzichten sollte.

All News & Updates of API Conference 2018:

Behind the Tracks

API Management

Ein detaillierter Blick auf die Entwicklung von APIs

API Business & Strategy

Innovationskraft und Wirtschaftlichkeit von APIs

API Development

Architektur von APIs und API-Systemen

API Design & Documentation

Von Policys und Identitys bis Monitoring

Microservices

Microservices Strukturen & Frameworks