Swagger
HTTP-Webservices
Swagger wird von vielen weiteren Tools erkannt und unterstützt. Während die meisten Benutzer bei „Swagger“ an das Swagger-UI-Tool denken, bietet das Swagger-Toolset Unterstützung für automatisierte Dokumentation, Code-Generierung und Testfallgenerierung. Swagger gehört neben RAML und API Blueprint zu den am häufigsten verwendeten API-Beschreibungssprachen.
Entwicklung von APIs
Bei der Erstellung von APIs kann Swagger Tooling verwendet werden, um automatisch ein Open-API-Dokument basierend auf dem Code selbst zu erzeugen. Dies wird informell als Code-First- oder Bottom-up-API-Entwicklung bezeichnet. Während der Softwarecode selbst das Open-API-Dokument genau darstellen kann, halten viele API-Entwickler dies für eine veraltete Technik, da er die API-Beschreibung in den Quellcode eines Projekts einbettet und es für Nicht-Entwickler typischerweise schwieriger ist, dazu beizutragen. Swagger unterstützt auch JAX-RS.
Alternativ können Entwickler mit Swagger Codegen den Quellcode vom Open-API-Dokument entkoppeln und Client- und Servercode direkt aus dem Entwurf generieren. Obwohl dies als kompliziert angesehen wird, wurde es von vielen Branchenexperten als ein modernerer API-Workflow angesehen und erlaubt mehr Freiheit bei der Gestaltung der API, indem der Coding-Aspekt verschoben wird.
Interaktion mit APIs
Mit dem swagger-codegen-Projekt generieren Endanwender Client-SDKs direkt aus dem Open-API-Dokument, wodurch der Bedarf an von Menschen generiertem Client-Code reduziert wird. Seit August 2017 unterstützt das Projekt swagger-codegen mehr als 50 verschiedene Sprachen und Formate für die Erstellung des Client-SDKs.
Dokumentation von APIs
Wenn durch ein Open-API-Dokument beschrieben, kann Swagger Open-Source-Tooling verwendet werden, um direkt mit der API über die Swagger-Benutzeroberfläche zu interagieren. Dieses Projekt ermöglicht die direkte Anbindung von Live-APIs über eine interaktive, HTML-basierte Benutzeroberfläche.
Weitere Informationen zu Swagger erhalten Sie unter
swagger.io