OpenAPI (OpenAPI Specification / OAS / Swagger)

Die OpenAPI Specification (ehemals Swagger) ist ein offener Standard zur maschinell lesbaren Beschreibung von REST-APIs, der Endpunkte, Parameter, Datenmodelle, Authentifizierungsverfahren und Fehlerreaktionen formal definiert. Auf Basis von OpenAPI-Dokumenten lassen sich automatisch Client-SDKs, Testsuiten und API-Portale generieren, was Integrationsaufwände erheblich reduziert. In IT-Vergaben für APIs und Schnittstellenleistungen sollten Auftraggeber die Bereitstellung einer validen OpenAPI-Spezifikation als Pflichtliefergegenstand fordern, da sie die Grundlage für neutrale Integrationstests und spätere Drittanbieterschnittstellen bildet.