Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

Are there any generators that support OpenAPI 3?

At the time of writing this the OpenAPI 3 spec is relatively new. I am struggling to find any documentation generators that support version 3.0.

Does anyone know of generators that support OpenAPI v3.0?

like image 878
MattC Avatar asked Sep 19 '17 02:09

MattC


People also ask

Is OpenAPI REST only?

Many older open APIs provide both a SOAP and REST base to support older clients, but newer implementations typically only provide REST-based access.

Does Postman support OpenAPI?

When importing your OpenAPI specification, Postman follows the endpoint hierarchy defined in the specification to create a collection organized into folders (if your OpenAPI has multiple levels of hierarchy). Postman uses the schemas defined in the OpenAPI to generate request and response bodies.

When did OpenAPI 3.0 come out?

On 1 January 2016, the Swagger specification was renamed the OpenAPI Specification (OAS), and was moved to a new GitHub repository. In September 2016, the API World conference presented an API Infrastructure award to SmartBear for its ongoing work on Swagger. In July 2017, the OpenAPI Initiative released version 3.0.

How do I switch from OpenAPI 3 to Swagger 2?

If you need to import a REST web-service that only has an OpenAPI v3 specification you can use https://www.apimatic.io/ to convert it to Swagger 2 (the type that the development studio needs).


1 Answers

You can try OpenAPI Generator (https://openapi-generator.tech), which supports both OpenAPI spec v2, v3 and released a stable version (3.0.0) a few days ago.

Using docker, you can easily generate the API documentation:

docker run --rm -v ${PWD}:/local openapitools/openapi-generator-cli generate \
    -i https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/2_0/petstore.yaml \
    -g html2 \
    -o /local/out/html2
like image 83
William Cheng Avatar answered Oct 02 '22 02:10

William Cheng