API Conference 2019
The Conference for Web APIs, API Design & Management
October 14 - 16, 2019 in Berlin

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

Session
Till June 6
✓ Workshop Day for free ✓ Arduino Starter Kit or Raspberry Pi for free ✓ Save up to € 484 Register now
Infos
Tuesday, September 25 2018
11:15 - 12:15

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 Business & Strategy

Innovative power and cost-effectiveness of APIs

API Development

Architecture of APIs and API systems

API Design & Documentation

From policies and identities to monitoring

Microservices

Microservices Structures & Frameworks