Swagger documentation and OpenAPI

The microservice architecture will drive the enterprise architecture ecosystem to build a huge number of APIs, through which data can be exposed and communication can be implemented between the various microservices.

For this reason, it is essential to document the API, in order to facilitate its proper use by users. To standardize how REST APIs are described, a consortium of forward-looking industry experts created the OpenAPI Initiative (OAI).

The OAI purpose is to create and evolve a vendor-neutral / standard description format.

SmartBear company donated the Swagger specification to the OAI in order to set it as the starting point of this open specification. For that reason, Swagger can be considered the ...

Get Hands-On Cloud-Native Microservices with Jakarta EE now with O’Reilly online learning.

O’Reilly members experience live online training, plus books, videos, and digital content from 200+ publishers.