V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
V2EX 提问指南
baojiweicn2
V2EX  ›  问与答

有好的接口维护的工具吗

  •  
  •   baojiweicn2 · 2019-04-23 17:26:31 +08:00 · 1519 次点击
    这是一个创建于 1823 天前的主题,其中的信息可能已经有所发展或是发生改变。

    用了 swagger,感觉非常不舒服,

    • 首先,用 yaml 作为接口文档定义的工具真的很麻烦
    • 其次,还有很多语法要去官方查,感觉非常难受

    所有有没有更加简单的接口文档维护的工具,虽然写 markdown 在 wiki 上也可以。 求的是一款不耗精力的接口文档维护平台,另外可以顺带 mock 就再好不过了。

    4 条回复    2019-04-24 09:34:03 +08:00
    baojiweicn2
        1
    baojiweicn2  
    OP
       2019-04-23 17:28:31 +08:00
    要是可以当即发一条请求,自动抓成接口文档就更好了,不然还要自己手动写很烦
    WhoMercy
        2
    WhoMercy  
       2019-04-23 21:11:40 +08:00
    如果是 Java 项目,可以了解一下 springfox-swagger (省去了 swagger 手写 yaml 的痛苦)
    AngryMagikarp
        3
    AngryMagikarp  
       2019-04-23 21:15:20 +08:00
    你说的这亮点都是你自己没有熟悉 swagger 而已。
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   我们的愿景   ·   实用小工具   ·   3258 人在线   最高记录 6543   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 26ms · UTC 10:45 · PVG 18:45 · LAX 03:45 · JFK 06:45
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.