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

各位你們是如何優雅的維護 Swagger2 文檔的

  •  
  •   leonard916 · 2020-01-27 14:22:07 +08:00 · 3507 次点击
    这是一个创建于 1762 天前的主题,其中的信息可能已经有所发展或是发生改变。

    RT

    註解模式太難受了,有的文檔比較長,寫起來就特球疼。還有一個問題是 POST 示例字符串死活配不上去。

    求大神解救,萬分感激。

    3 条回复    2020-01-27 15:20:01 +08:00
    mwVYYA6
        1
    mwVYYA6  
       2020-01-27 14:59:02 +08:00 via Android
    我们组的前端使用的 api 通过 swagger 生成,然后用起来有问题就找后端改 XD
    zdhxiong
        2
    zdhxiong  
       2020-01-27 15:14:30 +08:00
    先前后端共同编写好 swagger 文档。

    然后前端根据 swagger 生成的 mock 服务开发前端,后端根据文档实现接口,测试根据文档编写测试代码。
    aaahhh123
        3
    aaahhh123  
       2020-01-27 15:20:01 +08:00
    麻竹
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   2608 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 25ms · UTC 11:01 · PVG 19:01 · LAX 03:01 · JFK 06:01
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.