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

Die OpenAPI Specification aka Swagger – mehr als nur Schnittstellenbeschreibung

Session
This talk originates from the archive. To the CURRENT program
Till June 6
✓ Workshop Day for free ✓ Arduino Starter Kit or Raspberry Pi for free ✓ Save up to € 484 Register now

More talks in the program:

Infos
Tuesday, September 19 2017
16:30 - 17:30

Schnittstellen (APIs) zwischen Systemen wurden in der Vergangenheit häufig in der Web Services Description Language (WSDL) beschrieben. Technisch ist es mit WSDL 2.0 möglich, auch REST-Schnittstellen zu beschreiben. Aufgrund fehlender Ressourcenorientierung ist dies jedoch nur bedingt sinnvoll. Die Web Application Description Language (WADL) adressiert dieses Problem, gilt jedoch in der Praxis aufgrund der vorliegenden XML-Struktur als umständlich und wurde nie standardisiert.
Stattdessen hat sich “Swagger” durchgesetzt, eine leichtgewichtige Möglichkeit um APIs im JSON- bzw. YAML-Format zu definieren. Die Spezifikation wird seit einiger Zeit herstellerneutral unter dem Mantel der Linux Foundation von der Open API Initiative (OAI) weitergetrieben und seitdem unter dem Namen OpenAPI Specification geführt.
Neben dem generellen Funktionsumfang werden im Vortrag die Verbesserungen der Version 3 vorgestellt. Am Beispiel in Kombination mit JAX-RS, Apache CXF und Spring Boot wird verdeutlicht, wie einfach sich Schnittstellenbeschreibungen in den Alltag integrieren lassen.

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