
fastapi swagger 文档的嵌套展示
想要在 swagger 文档中展示嵌套结构,例如后台管理下包含用户管理和文章管理,用户管理下包含 a 接口和 b 接口,文章管理下包含 c 接口和 d 接口。
当前效果:
后台管理
用户管理
文章管理
期望效果:
后台管理
用户管理
文章管理
代码:
routerAdmin = APIRouter(
prefix='/admin',
tags=['后台管理']
)
# routerUser 包含 a, b 接口
routerAdmin.include_router(routerUser, prefix='/user')
# routerArticle 包含 c, d 接口
routerAdmin.include_router(routerArticle, prefix='/article')
app = FastAPI()
app.include_router(routerAdmin)实现:
目前 openapi 规范不支持嵌套结构。因此,无法使用 fastapi 的内置 swagger ui 来实现上述嵌套展示效果。
然而,可以通过使用第三方插件来实现嵌套展示。例如,fastapi-swaggerui-template 插件可以提供自定义 swagger ui 模版,并支持嵌套结构的展示。
但是,需要注意的是,第三方插件的使用可能会引入额外的依赖关系和复杂性,需要谨慎选择。
以上就是FastAPI Swagger文档如何实现嵌套接口展示?的详细内容,更多请关注php中文网其它相关文章!
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号