sphinxcontrib-openapi is a Sphinx extension to generate APIs docs from OpenAPI (fka Swagger) spec. It depends on sphinxcontrib-httpdomain that provides an HTTP domain for describing RESTful HTTP APIs, so we don't need to reinvent the wheel.
Pass sphinxcontrib-openapi
to extensions
list in Sphinx's conf.py
and feel free to use the openapi
directive to render OpenAPI specs