
SwaggerHub (free and commercial): API design and documentation, built for teams working with OpenAPI. Swagger Inspector (free): API Inspection tool that lets you generate OpenAPI definitions from existing API. Swagger Core: Java-related libraries for creating, consuming, and working with OpenAPI definitions. Swagger Parser: Standalone library for parsing OpenAPI definitions from Java. Swagger Codegen: Allows generation of API client libraries (SDK generation), server stubs and documentation automatically given an OpenAPI Spec. Swagger UI: Swagger UI is a collection of HTML, Javascript, and CSS assets that dynamically generate beautiful documentation from an OAS-compliant API.
Swagger Editor: Swagger Editor lets you edit OpenAPI specifications in YAML inside your browser and to preview documentations in real time. The Swagger toolset includes a mix of open source, free, and commercial tools, which can be used at different stages of the API lifecycle. Swagger is the name associated with some of the most well-known, and widely used tools for implementing the OpenAPI specification. Smartbear Software, which is the company that leads the development of the Swagger tools, is also a member of the OpenAPI Initiative, helping lead the evolution of the specification. The development of the specification is fostered by the OpenAPI Initiative, which involves more the 30 organizations from different areas of the tech world - including Microsoft, Google, IBM, and CapitalOne. The OpenAPI is the official name of the specification. Swagger = Tools for implementing the specification. The easiest way to understand the difference is: Let’s start with clarifying Swagger vs OpenAPI And there has also been a lot of confusion about the difference between OpenAPI and Swagger, when to use one name over the other, and what the relationship is between OpenAPI and Swagger. In the last two years there have been a lot of questions about the change from Swagger to OpenAPI.
Why? One of the most notable reasons why the release is so important is that OpenAPI 3.0 is the first official release of the specification since it was donated to the OpenAPI Initiative by SmartBear Software and renamed from the Swagger Specification to OpenAPI specification in 2015.īefore we go into some of the reasons why OpenAPI 3.0 is so important to the API space, it’s important to first clear up some questions about OpenAPI and what it means for Swagger. This year marked the official release of OpenAPI 3.0, the latest version of the OpenAPI specification.įor those involved in API development, the release of OAS 3.0 is, well… kind of a big deal.