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

有没有类似 swagger 的开源工具

  •  
  •   gkiwi · 2017-11-06 18:09:38 +08:00 · 8843 次点击
    这是一个创建于 2585 天前的主题,其中的信息可能已经有所发展或是发生改变。

    swagger 比较强大,但是 yaml 配置起来有点繁琐,特别是单文件里面配置东西的时候,几百行操作起来有点难度; 尝试了 easy-mock,UI 风格各方面都很棒,但是在注释和生成查阅类的文档,就不可以了;

    所以想问下有没有两者的中间产品(且 MIT 开源),满足如下条件:

    1. 可以使用类似 md 语法进行书写,并且可以很好的进行分组(一个 api 一个文档最棒);
    2. 支持类似 mockjs 语法(当然可以换成其它的);
    3. 生成文档容易阅读(swagger 就很棒了);

    swagger 研究的也不多,本地 run 起来过,但是详细 document 还没看。 blueprint 似乎不错,之前用过他们线上版本,但是还没进行过本地部署试用。

    想问问大家有啥建议没

    7 条回复    2018-11-23 15:40:28 +08:00
    xiubao
        1
    xiubao  
       2017-11-06 18:19:11 +08:00
    有一款,你可以看下;是开源免费的
    地址: http://www.doclever.cn
    gkiwi
        2
    gkiwi  
    OP
       2017-11-06 18:28:11 +08:00
    @xiubao #1 非常感谢。看了下功能方面很棒,不过:



    这个我就不太敢用了。虽然不会拿去卖钱,但是内网使用,也算是为商业应用提供服务的,估计架构师那边过不了= =
    gkiwi
        3
    gkiwi  
    OP
       2017-11-06 18:31:08 +08:00
    @gkiwi #2 看到滴滴美团他们在用= = ::doge
    acoder2013
        4
    acoder2013  
       2017-11-06 18:40:29 +08:00
    http://apidocjs.com/ 这个还不错,只用写注释就可生成文档,不过不支持 mock
    xiubao
        5
    xiubao  
       2017-11-07 09:19:48 +08:00
    @gkiwi 不会的,团队可直接线下部署;只要不是用来做商业用途,商业用途是指用来运营,倒卖;团队线下部署是肯定可以的,不会有任何问题
    xiaour
        6
    xiaour  
       2018-09-13 10:08:13 +08:00
    backache
        7
    backache  
       2018-11-23 15:40:28 +08:00
    @xiaour 要是能加上字段描述就好了
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   1013 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 24ms · UTC 20:53 · PVG 04:53 · LAX 12:53 · JFK 15:53
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.