OpenAPI 3.0, which is based on the original Swagger 2.0 specification, is meant to provide a standard format to unify how an industry defines and describes RESTful APIs.
The release of OAS 3.0 marks a significant milestone in the growth of the API economy — bringing together collaborators from across industries, to evolve the specification to meet the needs of API developers and consumers across the world in an open and transparent manner.
This week, we hosted a free Swagger training: OpenAPI 3.0, And What it Means for the Future of Swagger. More than 2,000 people signed up to learn more about the new specification, and to find out about what’s coming next for Swagger and SwaggerHub!
You can watch the full recording of the webinar below. Along with the recording, we’ve included a breakdown of the main topics that were covered with a time stamp to help you find the information that’s most valuable to you.
Overview of the OpenAPI Initiative [2:30]
The OpenAPI Initiative is the governing body that leads the development and evolution of the OAS. SmartBear Software donated the Swagger specification to the OpenAPI Initiative in 2015, and has continued to actively work with the other 27 OAI members to develop the next version of the specification.
Understanding the Relationship of Swagger and OpenAPI, OAS, & OAI [8:30]
The specification is officially named OpenAPI 3.0, but Swagger will continue to be an ecosystem of tooling provided by SmartBear Software.
What’s New in OpenAPI 3.0 [10:20]
Ron Ratovsky, Swagger Developer Evangelist at SmartBear Software, provides a detailed look at some of the biggest changes in OpenAPI 3.0, including: improved examples, enhanced security definitions, support for describing callbacks, and more.
Switching from OpenAPI (Swagger) 2.0 to OpenAPI 3.0 [32:00]
OpenAPI 3.0 includes breaking changes from the 2.0 version of the spec. See what you need to know to switch from 2.0 to 3.0.
How OAS 3.0 Fits into the API Lifecycle [34:50]
OpenAPI and Swagger have always been known for API design and documentation, but OAS 3.0 has the power to improve the entire lifecycle of your APIs.
Overview of Swagger Tools [ 39:30]
Get an overview of the powerful tools in the Swagger ecosystem, including the integrated SwaggerHub platform.
Timeline of Support for OpenAPI [44:00]
Swagger UI and Swagger Editor both offer support for OAS 3.0! See when your other favorite Swagger tools will support OAS 3.0.
Live Swagger Demo [47:35]
Get a sneak peek at OAS support in Swagger Editor and UI, and a new Swagger Converter tool that will be released later this month.
Get started today
Thank you to everyone that tuned in for this week’s training! The open source Swagger Editor and Swagger UI already offer support for OAS 3.0, and we will be releasing support for OAS 3.0 in SwaggerHub in September. SwaggerHub brings together the capabilities of the open source Swagger tooling, with advanced capabilities to help teams collaborate on the design and documentation of their APIs with OAS.