Session Details

API Conference 2017
Die Konferenz für Web APIs, API Design & Management
18. - 20. September 2017 in Berlin

de

19 Sep 2017
16:30 - 17:30
Kollegenrabatt 3+ Kollegen anmelden und 10% Rabatt sichern! Jetzt anmelden

Die OpenAPI Specification aka Swagger – mehr als nur Schnittstellenbeschreibung

19 Sep 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.

Session Themen

#API Management

Behind the Tracks

Web API Development

Ein detaillierter Blick auf die Entwicklung von APIs

API Design & Microservices

Architektur von APIs und API-Systemen

API Management

Von Policys und Identitys bis Monitoring