The Swagger framework changed the software landscape forever, allowing APIs to be described in a common language (the OpenAPI Specification) that every human and machine involved in the lifecycle can understand, work and integrate with.
While the specification is the core of the framework, there is an entire toolchain around it to enhance the API development process. The most popular and fundamental tools to better implement the Swagger framework are the Swagger Editor and Swagger UI.
The Swagger UI gave life to the OpenAPI Specification (formerly the Swagger Specification), allowing users to visualize and interact with the API in a format that’s easy to read and understand. The Swagger Editor, another popular open source project, is the de facto editor for designing APIs in the OpenAPI Specification. Together, the Swagger Editor and UI have become the standard tools to design, document and visualize RESTFul APIs. The combination of the Swagger Editor and UI is downloaded once every 3 seconds.
Now, two years after the last major update, the next version of these tools is finally here.
What’s new in the Swagger Editor and UI?
The new Swagger Editor and UI, accommodate feedback from tens of thousands of members from the developer community, and like their predecessors, are fully open source.They bring speed and reliability to the forefront of the API design and documentation process. The size of the tools has been reduced by 80 percent, which makes for a more agile experience designing concrete, robust and long APIs. They also introduce extensibility mechanisms that allow users to fully customize the interface and build their own functionality on top of the core Swagger platform.
The new Swagger Editor and UI have been reengineered from the ground up, merging the codes into one unified codebase, that will make it easier to work with and contribute to the open source projects. This unified experience establishes a common framework for developers and end users to design, engineer and consume APIs written in the OpenAPI Specification.
The newest version of the Swagger Editor and UI lays the groundwork for compatibility with the future OpenAPI Specification 3.0, when it is released later this year.
If you have any questions, you can visit our FAQ section.
The repositories for the specific projects are below:
Swagger-UI: https://github.com/swagger-api/swagger-ui
Swagger-Editor: https://github.com/swagger-api/swagger-editor
The Swagger Team will be demoing the new Swagger Editor and UI at our meetup at Mashape HQ in San Francisco on March 30. Learn more.