OpenAPI (Swagger)
OpenAPI (auch bekannt als Swagger) ist zu einem Standard für die Spezifikation von REST Schnittstellen geworden.
Nach dem API-first-Ansatz definieren wir die Schnittstelle mit YAML und JSON-Objekten. Daraus resultieren viele fürs Projekt wichtige Artefakte, unter anderem eine leicht zugängliche und gut lesbare Dokumentation, Test Clients und Client- bzw. Server-Stubs.
Durch die grosse Community ist OpenAPI gut in die heutigen Entwicklungsumgebungen (IDE) integriert. Eine grosse Toolset Basis, die laufend weiterentwickelt wird, erleichtert das Arbeiten zusätzlich.