有没有办法为 Rails API 生成交互式文档?

Is there a way to generate an interactive documentation for Rails APIs?

我的意思是类似于生成 FastApi, but for a Rails API. I know there is rswag 的交互式文档,但要使用它,我需要编写 Rspec 文件,并在其他文件中描述我的端点,然后生成 json 或 xml 由 rswag-ui 或类似的东西解释。如果我的测试已经全部使用 minitest 怎么办?重写 Rspec?

但是有没有捷径可以做到这一点?比如,在我的控制器上写下方法名称和描述,以便 OAS 生成器读取?并且不必在每次更改控制器、路由或响应的某些参数时更新我的​​ OAS JSON 文件,因为它会自动更新。当然包括项目中的 UI。

已经有这样的神器了?或者处于初始状态的项目试图做类似的事情?

我使用 Apipie 生成 swagger 文件和本地文档,如您在其演示中所见。您基本上编写 ruby 代码来生成文档。