Why?

This project is aimed at getting API developers the best tools and knowledge possible. As OpenAPI v3 rolls out, we want to push developers towards that standard and leave OpenAPI v2 behind.

This project will describe what linters, documentation tools, code generators and more are already on OpenAPI 3.x

Contribute

This project was created by Matthew Trask and Phil Sturgeon with contributions from the community. If you need help, hit Matt or Phil up on twitter.

Current OpenAPI Version

3.0.1 - Link to the specification

Converters

Name	Language	v2	v3	GitHub
swagger2openapi - An OpenAPI / Swagger 2.0 to OpenAPI 3.0.x converter and validator	Node.js	✅	✅
OData OpenAPI - OData 4.0 to OpenAPI 3.0.0 converter	XSLT	✅	✅
OpenAPI Filter - Filter internal components from OpenAPI definitions	Node.js	✅	✅
OData.OpenAPI - Convert an Edm (Entity Data Model) to OpenApi 3.0	.NET	❌	✅
pyswagger	Python	✅	👷

Back to top

Editors

Name	Language	v2	v3	GitHub
KaiZen-OpenAPI-Editor	Java	✅	✅
Swagger Editor	Node.js	✅	✅
RepreZen API Studio - RepreZen API Studio is an integrated workbench that brings API-first design into focus for your whole team, harmonizes your API designs, and generates APIs that click into client apps.	Java	✅	✅
Apicurio Studio - A standalone API design studio that can be used to create new or edit existing API designs.	TypeScript	✅	✅
Rápido - An API design tool that facilitates the sketching phase of design.	Node.js	✅	✅

Back to top

Linters

Name	Language	v2	v3	GitHub
swagger2openapi - swagger2openapi also includes configurable linter	Node.js	✅	✅

Back to top

Parsers

Name	Language	v2	v3	GitHub
swagger-parser - Swagger 1.0, 1.1, 1.2, 2.0 to OpenAPI Specification parser	Java	✅	❌
KaiZen OpenAPI Parser - High-performance Parser, Validator, and Java Object Model for OpenAPI 3.x	Java	❌	✅
OpenAPI-TS - TS Model & utils for OpenAPI 3.0.x contracts	TypeScript	❌	✅
kin-openapi - A Go library for handling OpenAPI 3.0 specifications	Go	❌	✅
OpenAPI3-Rust - Rust serialization library for OpenAPI v3	Rust	❌	✅
psx-api - Parse and generate API specification formats	PHP	✅	✅

Back to top

Code Generators

Name	Language	v2	v3	GitHub
Swagger-Codegen - Design, Build, and Document APIs in the Cloud with SwaggerHub	Java	✅	❌
generator-openapi-repo - Generate the repository structure for a scalable OpenAPI definition	JavaScript	✅	❌

Back to top

Documentation

Name	Language	v2	v3	GitHub
openapi-viewer - Browse and test a REST API described with the OpenAPI 3.0 Specification	Vue.js	❌	✅
openapi-ui - React based OpenAPI 3.0+ documentation generator	React.js	❌	✅
Spectacle - Spectacle generates beautiful static HTML5 documentation from OpenAPI/Swagger 2.0 API specifications	JavaScript	✅	❌
ReDoc - OpenAPI/Swagger-generated API Reference Documentation	JavaScript	✅	👷
widdershins - Generate Slate/Shins markdown from OpenAPI 3.x and 2.0	Node.js	✅	✅

Back to top