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.

Projekte zu diesem Know‑how