OAS 3.0, which is based on the Swagger 2.0 specification, adds major improvements and new functionality including: increased reusability, extended JSON Schema functionality, and enhanced security definitions.
The Swagger UI and Swagger Editor are among the most widely used tools for designing and documenting RESTful API using the OpenAPI Specification. This latest release enables users to use the Swagger Editor to describe OAS 3.0 APIs, and the Swagger UI to visual and automatically generate documentation of an API defined in OAS 3.0.
This is the first version to support OAS 3.0, and we will be releasing additional updates to extend the support for OAS 3.0.
You can read the full release notes for this release on GitHub: Swagger Editor and Swagger UI. This includes an overview of what’s new, and known limitations which will be addressed in future releases.
As an open source project, the team relies on community feedback to improve the tools. We invite you to share your feedback by filing a ticket on the project repositories.
See What’s Next for Swagger on August 9th
On August 9, SmartBear and the Swagger team will be presenting a live online training on OAS 3.0 —OpenAPI 3.0, And What it Means for the Future of Swagger.
The training will be presented by Ole Lensmar, CTO, SmartBear Software & Chair of the OpenAPI Initiative and Ron Ratovsky, Swagger Developer Evangelist and Member of the OpenAPI Technical Development Community.
During this training, we will introduce some of the newest features coming in OAI 3.0. We will also share insight into the work being done in the Swagger community, and showcase some of the excited developments for the Swagger tooling.
Get a head start on OAS 3.0, and see what’s coming next from Swagger.