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?
Many older open APIs provide both a SOAP and REST base to support older clients, but newer implementations typically only provide REST-based access.
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.
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.
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).
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
If you love us? You can donate to us via Paypal or buy me a coffee so we can maintain and grow! Thank you!
Donate Us With