API Conference 2020
The Conference for Web APIs, API Design & Management
April 20 - 22, 2020 in The Hague, Netherlands

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

Session
This talk originates from the archive. To the CURRENT program
Until December 19
✓ Workshop Day for free ✓ Raspberry Pi or C64 Mini for free ✓ Save up to €584 Register now
Infos
Tuesday, September 25 2018
11:15 - 12:15
Room:
Salon 4

Der Erfolg eines 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 2019:

Behind the Tracks

API Management

A detailed look at the development of APIs

API Development

Architecture of APIs and API systems

API Design & Documentation

From policies and identities to monitoring

API Platforms & Software as a Service

Web APIs for a larger audience & API platforms related to SaaS