

The OpenAPI Specification has undergone 3 revisions since initial creation in 2010. Companies/Projects using Swagger Codegen.Generating static html api documentation.Generating dynamic html api documentation.API documentation generators: HTML, Confluence WikiĬheck out OpenAPI-Spec for additional information about the OpenAPI project.


API clients: ActionScript, Ada, Apex, Bash, C# (.net 2.0, 3.5 or later), C++ (cpprest, Qt5, Tizen), Clojure, Dart, Elixir, Elm, Eiffel, Erlang, Go, Groovy, Haskell (http-client, Servant), Java (Jersey1.x, Jersey2.x, OkHttp, Retrofit1.x, Retrofit2.x, Feign, RestTemplate, RESTEasy, Vertx, Google API Client Library for Java, Rest-assured), Kotlin, Lua, Node.js (ES5, ES6, AngularJS with Google Closure Compiler annotations) Objective-C, Perl, PHP, PowerShell, Python, R, Ruby, Rust (rust, rust-server), Scala (akka, http4s, swagger-async-httpclient), Swift (2.x, 3.x, 4.x, 5.x), Typescript (Angular1.x, Angular2.x, Fetch, jQuery, Node).Currently, the following languages/frameworks are supported: This is the Swagger Codegen project, which allows generation of API client libraries (SDK generation), server stubs and documentation automatically given an OpenAPI Spec. Swagger Codegen 2.X supports Swagger/OpenAPI version 2. NOTE: this document refers to version 2.X, check here for 3.X. Online generator of version 3.X supports both generation from Swagger/OpenAPI version 2 (by using engine + generators of 2.X) and version 3 specifications. While 3.X ( 3.0.0 branch) supports OpenAPI version 3 (and version 2 via spec conversion to version 3). NOTE: version 2.X ( io.swagger) and 3.X ( io.3) have different group ids.Ģ.X and 3.X version lines of Swagger Codegen are available 2.X ( master branch) supports Swagger/OpenAPI version 2, 📔 The eBook A Beginner's Guide to Code Generation for REST APIs is a good starting point for beginners. ⚠️ If the OpenAPI/Swagger spec is obtained from an untrusted source, please make sure you've reviewed the spec before using Swagger Codegen to generate the API client, server stub or documentation as code injection may occur ⚠️ 📔 For more information, please refer to the Wiki page and FAQ 📔 ⭐ ⭐ ⭐ If you would like to contribute, please refer to guidelines and a list of open tasks.
