OpenAPI-Specification

Implementations

Below is a list of known tooling that implements the 3.0.0 specification. While support for the 3.0.0 specification matures, refer to the details of projects listed below for any notes about stability and roadmap. The process to improve the 3.x specification includes feedback from end-users and tooling creators. We strongly encourage draft tooling be made available for early users of OAS drafts.

These tools are not endorsed by the OAI.

Low-Level tooling

Title Project Link Language Description
swagger-parser github/swagger-api Java Swagger 1.0, 1.1, 1.2, 2.0 to OpenAPI Specification converter
swagger-models github/swagger-api Java OpenAPI 3.0 Java Pojos
KaiZen OpenAPI Parser github/RepreZen/KaiZen-OpenAPI-Parser Java High-performance Parser, Validator, and Java Object Model for OpenAPI 3.x
openapi3-ts github/metadevpro/openapi3-ts TypeScript TS Model & utils for OpenAPI 3.0.x contracts
swagger2openapi github/mermade/swagger2openapi Node.js An OpenAPI / Swagger 2.0 to OpenAPI 3.0.x converter and validator
Microsoft.OpenApi.net github/microsoft/OpenApi.net dotnet C# based parser with definition validation and migration support from V2
odata-openapi github/oasis-tcs/odata-openapi XSLT OData 4.0 to OpenAPI 3.0.0 converter
openapi3_parser github/kevindew/openapi3_parser Ruby A Ruby implementation of parser and validator for the OpenAPI 3 Specification
oas_parser github/Nexmo/oas_parser Ruby An open source OpenAPI Spec 3 Definition Parser writen in Ruby
oas3-remote-refs github//OverSpeedIO/oas3-remote-refs Node.js Tool to pull remote refernences and merge them into the definitions of the provided OpenAPI3 speicfication.
go-openapi github/nasa9084/go-openapi Go Golang struct model for OpenAPI 3.x.
openapi github/wzshiming/openapi Go OpenAPI 3 Specification for golang

Editors

Title Project Link Language Description
Apicurio Studio github/Apicurio/apicurio-studio Java/Typescript Web-Based visual designer for OpenAPI 2.0 and 3.0.0.
KaiZen OpenAPI Editor github/RepreZen/KaiZen-OpenAPI-Editor Java Eclipse Editor for OpenAPI 2.0 and 3.0
RepreZen API Studio RepreZen.com/OpenAPI Java Commercial desktop IDE for API design, documentation & development
OpenAPI-gui github/Mermade/openapi-gui Node.js GUI / visual editor for creating and editing OpenAPI definitions
SwaggerHub swaggerhub.com   API Design and Documentation Platform, Built For Teams
swagger-editor github/swagger-api JavaScript Web-Based editor for creating, editing, validating and testing OpenAPI\Swagger definitions

User Interfaces

Title Project Link Language Description
openapi-viewer github/koumoul/openapi-viewer Vue.js Browse and test a REST API described with the OpenAPI 3.0 Specification.
swagger-ui github/swagger-api JavaScript Web-Based interface for visualizing and testing OpenAPI\Swagger definitions
lincoln github/temando/open-api-renderer React.js A React renderer for OpenAPI v3
WebSphere Liberty Download jar JavaScript Includes a native OpenAPI v3 UI which allows for customization of its banners and URL
Widdershins github/Mermade/widdershins Node.js Generate Slate/Shins markdown from OpenAPI 3.0.x
angular-swagger-ui github/angular-swagger-ui AngularJS An angularJS implementation of Swagger UI

Server Implementations

| Title | Project Link | Language |Description | |—————-|————–|———-|———————| | Vert.x Web API Contract | github/vert-x3/vertx-web | Java, Kotlin, JavaScript, Groovy, Ruby, Ceylon & Scala | Create an API endpoint with Vert.x 3 and OpenAPI 3 with automatic requests validation | Fusio | github/apioo/fusio | PHP, JavaScript | Build API endpoints based on OpenAPI 3 | Modern | github/modern-project/modern-ruby | Ruby | OpenAPI 3-based Rack framework with automatic OAS generation and requests/response validation | Koa2-OAS3 | github/OverSpeedIO/koa2-oas3 | Node.js | OpenAPI 3 request validation middleware for Koa2 based apps. | Exegesis | github/exegesis-js/exegesis | Node.js | OpenAPI 3 server-side framework for express and other frameworks.

Code Generators

Title Project Link Language Description
baucis-openapi3 github/metadevpro/baucis-openapi3 Node.js Baucis.js plugin for generating OpenAPI 3.0 compliant API contracts.
Google Gnostic github/googleapis/gnostic Go Compile OpenAPI descriptions into equivalent Protocol Buffer representations.
Gen github/wzshiming/gen Go Generate OpenAPI 3, client, and route based on golang source code.
serverless-openapi-documentation github/temando/serverless-openapi-documentation Typescript Serverless 1.0 plugin to generate OpenAPI V3 documentation from serverless configuration
zero-rails_openapi github/zhandao/zero-rails_openapi Ruby Provide concise DSL for generating the OpenAPI Specification 3 documentation file for Rails application
slush-vertx github/pmlopes/slush-vertx Java, Kotlin & Groovy Generate server skeleton for Vert.x Web API Contract and API Client based on Vert.x 3 Web Client
WebSphere Liberty Download jar Java EE Generates OpenAPI v3 documentation from Java EE applications
swagger-node-codegen github/fmvilas/swagger-node-codegen Node.js Generates a Node.js/express server, but also has a template engine for creating any templates needed.