刚刚体验了一下 Swagger,感觉用它来生成项目的文档以及测试接口确实很方便。但感觉把它用在大项目上,似乎有些麻烦。
看了一下 httpbin 的例子,Swagger 似乎只支持对接口进行一级分组(HTTP Method
一组,Auth
一组,等等)。
请问 Swagger 可以支持多级分组么?例如 论坛模块 是一组,论坛模块 下面又分为 帖子模块, 文章模块 等,然后这些子模块中各自有若干个接口。
同时在 SwaggerUI (或其他查看工具)中, 每组接口各自有一个页面,而 不是把所有接口堆在一个页面中 ,感觉如果 4 5 百个接口同时在一个页面中,那样在 SwaggerUI 中查看起来太麻烦了。
1
Trim21 2019-11-23 18:07:20 +08:00 via Android
应该是不能吧。当初我也想这么干,然后发现一个接口添加两个 tag 之后甚至会在两个 tag 里面重复显示
|
3
Muninn 2019-11-23 23:38:10 +08:00
右上角可以切换配置啊,你把这个当做第一级就好了。
|
5
Muninn 2019-11-24 22:31:36 +08:00
不用输入,启动 swagger 的配置选项里可以配置多个配置文件,还可以给配置文件起名字。
总之我的界面和你不太一样,我用的是官方出的 docker 版 ui,然后用 ci 自动生成若干配置文件。 |
6
Muninn 2019-11-24 22:32:21 +08:00
我的右上角就是一个下拉列表,没有那个按钮。
|