swagger 的 API 界面做得很炫,strongloop 就整合了 swagger 的 API 界面。有这样整合过的吗? http://swagger.io/
5 回复
swagger思路是不错,不过尽量避免单独使用,同时维护两套Model是很耗损开发人员精力的。loopback已经帮你实现了简单的封装过程,所以自己不太需要什么整合了。 话又说回来,我个人还是认为使用Firedoc这样的工具会比较靠谱一点,因为现在我团队的swagger基本处于随便用用的状态,搜索UI再炫也没有curl灵活可用,而且还容易出现bug,又需要分散精力去fix,况且他界面真心不酷炫的说。 可能swagger更适合嵌入到你自己开放平台中去,给你的用户去当作产品去使用,而不是在开发阶段给前端人员使用。
https://github.com/fireball-x/firedoc/tree/master/themes 这里是主题的列表,至于文档最终的样子:
- 默认UI在这里:http://docs-zh.fireball-x.com/api/
- 另外还支持直接生成markdown,firedoc在github自己的文档就是自己生成的,勉强算是自举吧哈哈:https://github.com/fireball-x/firedoc/tree/master/docs