Any update please?

@kulsingh0 Try switching to new renderer on latest version. Add openapi_default_renderer='httpdomain' to conf.py

@igo95862 that doesn't seem to solve the problem for me:

Sphinx==3.4.3
sphinxcontrib-httpdomain==1.7.0
sphinxcontrib-openapi==0.7.0

It also doesn't work on the test API spec: https://github.com/sphinx-contrib/openapi/blob/master/tests/testspecs/v3.0/petstore-expanded.yaml

Yields:

I recently discovered this issue (xref pangeo-forge/pangeo-forge-orchestrator#28). In that project, we are trying to include API documentation from a fastapi api object directly in a sphinx website. I imagine this is a very common scenario for python devs in 2022. We accomplish this with the following simple code in conf.py.

import yaml
from pangeo_forge_orchestrator.api import api  # created by FastAPI()

api_spec = api.openapi()  # openapi-style dictionary 
with open("openapi.yaml", mode='w') as fp:
    yaml.dump(api_spec, fp)

Plus the following RST in our sphinx site

.. openapi:: openapi.yaml

Fastapi exports openapi 3.0.x style metadata. The bug described here means that response and request JSON are not rendered. (See example site.)

We see two possible options to resolve the problem:

• Implement a manual translation step, wherein we reformat api_spec to use the swagger-style nesting of response objects
• Help resolve this problem upstream, i.e. in sphinxcontrib.openapi

Would the maintainers be willing to sketch out a roadmap of what it would take to fix this bug? We may be able to allocate developer time to such an effort if the path is clear.

I just noticed the same problem.
Sphinx==4.5.0
sphinxcontrib-httpdomain==1.8.0
sphinxcontrib-openapi==0.7.0

Adding openapi_default_renderer='httpdomain' to conf.py, also did not solve the problem for me.

Is there a timeline when solution can be expected?

This issue appears to be related to the resolution of references in the schemas.

The line

Appears to be missing from the new renderer. Inserting this line at

and updating the includes (plus openapi_default_renderer='httpdomain') resolves the issue for me.

I've made a fork with the update applied at:

https://github.com/david-i-berry/sphinxcontrib-openapi

I've only tested with my use case but it renders as expected (i.e. with the request and response objects now shown).

I just hit this issue with $ref in the responses on openapi 3.0.1. The fix from @david-i-berry on July 4, 2023 worked perfectly for me with both HTML and PDF. Any chance we can get this into a build?