V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
bwangel
V2EX  ›  程序员

请问 Swagger 支持对接口进行多级分组么

  •  
  •   bwangel ·
    bwangelme · 2019-11-23 17:59:30 +08:00 · 3024 次点击
    这是一个创建于 1833 天前的主题,其中的信息可能已经有所发展或是发生改变。

    前言

    刚刚体验了一下 Swagger,感觉用它来生成项目的文档以及测试接口确实很方便。但感觉把它用在大项目上,似乎有些麻烦。

    疑问

    看了一下 httpbin 的例子,Swagger 似乎只支持对接口进行一级分组(HTTP Method 一组,Auth一组,等等)。

    请问 Swagger 可以支持多级分组么?例如 论坛模块 是一组,论坛模块 下面又分为 帖子模块, 文章模块 等,然后这些子模块中各自有若干个接口。

    同时在 SwaggerUI (或其他查看工具)中, 每组接口各自有一个页面,而 不是把所有接口堆在一个页面中 ,感觉如果 4 5 百个接口同时在一个页面中,那样在 SwaggerUI 中查看起来太麻烦了。

    6 条回复    2019-11-24 22:32:21 +08:00
    Trim21
        1
    Trim21  
       2019-11-23 18:07:20 +08:00 via Android
    应该是不能吧。当初我也想这么干,然后发现一个接口添加两个 tag 之后甚至会在两个 tag 里面重复显示
    bwangel
        2
    bwangel  
    OP
       2019-11-23 19:10:01 +08:00
    @Trim21 好吧。。那感觉在大项目中没法统一用啊,只能模块维护一份自己的 Swagger.yaml 文件。
    Muninn
        3
    Muninn  
       2019-11-23 23:38:10 +08:00
    右上角可以切换配置啊,你把这个当做第一级就好了。
    bwangel
        4
    bwangel  
    OP
       2019-11-24 00:32:41 +08:00
    Muninn
        5
    Muninn  
       2019-11-24 22:31:36 +08:00
    不用输入,启动 swagger 的配置选项里可以配置多个配置文件,还可以给配置文件起名字。

    总之我的界面和你不太一样,我用的是官方出的 docker 版 ui,然后用 ci 自动生成若干配置文件。
    Muninn
        6
    Muninn  
       2019-11-24 22:32:21 +08:00
    我的右上角就是一个下拉列表,没有那个按钮。
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   2860 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 25ms · UTC 06:19 · PVG 14:19 · LAX 22:19 · JFK 01:19
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.