Wat is het verschil tussen OpenAPI en Swagger? Welke versie gebruikt u?

OpenAPI is een specificatie voor het beschrijven van RESTful API's, waarmee gestandaardiseerd kan worden hoe webservice-interfaces worden beschreven. Swagger was oorspronkelijk een tool en ecosysteem voor het werken met API's, inclusief het genereren van documentatie, client-SDK's en server-stubs.

In 2016 werd de Swagger-specificatie hernoemd naar OpenAPI Specification (OAS) en overgedragen aan de Linux Foundation onder de auspiciën van de OpenAPI Initiative. Tegenwoordig is OpenAPI een standaard, en Swagger is een verzameling tools die deze standaard ondersteunen.

Meestal wordt de laatste stabiele versie van de OpenAPI Specification gebruikt, die in 2024 OpenAPI 3.1.x is, omdat deze een meer flexibele beschrijving ondersteunt, inclusief volledige compatibiliteit met JSON Schema.

Voorbeeld van het gebruik van OpenAPI 3.1: