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

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

  •  
  •   bwangel · 64 天前 · 956 次点击
    这是一个创建于 64 天前的主题,其中的信息可能已经有所发展或是发生改变。

    前言

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

    疑问

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

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

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

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

    总之我的界面和你不太一样,我用的是官方出的 docker 版 ui,然后用 ci 自动生成若干配置文件。
    Muninn
        6
    Muninn   63 天前
    我的右上角就是一个下拉列表,没有那个按钮。
    关于   ·   FAQ   ·   API   ·   我们的愿景   ·   广告投放   ·   感谢   ·   实用小工具   ·   1322 人在线   最高记录 5168   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.3 · 23ms · UTC 00:59 · PVG 08:59 · LAX 16:59 · JFK 19:59
    ♥ Do have faith in what you're doing.