Skip to content

[18.0][ADD] openapi_doc_viewer: browse the OpenAPI docs in one page - #183

Draft
simahawk wants to merge 2 commits into
OCA:18.0from
camptocamp:18-add-openapi_doc_viewer
Draft

simahawk wants to merge 2 commits into
OCA:18.0from
camptocamp:18-add-openapi_doc_viewer

Conversation

@simahawk

Copy link
Copy Markdown
Contributor

Depends on

Motivation

Each module exposing docs would otherwise need its own page to browse them. This module gives one page to browse every documentation source the current user can see, so the modules built on openapi_doc_base don't need a controller just to be visible.

Key features

  • /openapi/docs: one page listing every docs source, filterable by category and app
  • /openapi/docs/<key>.json: the OpenAPI document of each source
  • also available in Settings > Technical > API docs
  • each source shown only to the users in its groups (and the groups of its category)

Viewer for OpenAPI docs: one page to browse all the docs the current user can see:
`/openapi/docs`, w/ category and app selectors
(also in Settings > Technical > API docs).

Sources are filtered by their groups and the groups of their category
(see `openapi_doc_base`).
Pending OCA#181 (openapi_doc_base).
To be removed once merged.
@OCA-git-bot OCA-git-bot added series:18.0 mod:openapi_doc_viewer Module openapi_doc_viewer labels Oct 16, 2026
simahawk added a commit to camptocamp/web-api that referenced this pull request Oct 16, 2026
Pending OCA#183 (openapi_doc_viewer) and OCA#181 (openapi_doc_base).
To be removed once merged.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

mod:openapi_doc_viewer Module openapi_doc_viewer series:18.0

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants