• 请不要在回答技术问题时复制粘贴 AI 生成的内容
gkiwi
V2EX  ›  程序员

有没有类似 swagger 的开源工具

  •  
  •   gkiwi · Nov 6, 2017 · 9903 views
    This topic created in 3292 days ago, the information mentioned may be changed or developed.

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

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

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

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

    想问问大家有啥建议没

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



    这个我就不太敢用了。虽然不会拿去卖钱,但是内网使用,也算是为商业应用提供服务的,估计架构师那边过不了= =
    gkiwi
    gkiwi
    OP
    Nov 6, 2017
    3
    @gkiwi #2 看到滴滴美团他们在用= = ::doge
    acoder2013
    acoder2013
    Nov 6, 2017
    4
    http://apidocjs.com/ 这个还不错,只用写注释就可生成文档,不过不支持 mock
    xiubao
    xiubao
    Nov 7, 2017
    5
    @gkiwi 不会的,团队可直接线下部署;只要不是用来做商业用途,商业用途是指用来运营,倒卖;团队线下部署是肯定可以的,不会有任何问题
    backache
    backache
    Nov 23, 2018
    7
    @xiaour 要是能加上字段描述就好了
    About   ·   Help   ·   Advertise   ·   Blog   ·   API   ·   FAQ   ·   Privacy   ·   Solana   ·   2292 Online   Highest 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 410ms · UTC 13:27 · PVG 21:27 · LAX 05:27 · JFK 08:27
    ♥ Do have faith in what you're doing.