Api 什么是狂妄自大？为什么'；在线编辑器不能运行请求吗？

在过去的几天里，我一直在试图弄清楚我是应该使用api蓝图、RAML还是招摇过市

看起来swagger拥有最大的社区，但我看得越近，就越觉得它在文档方面非常缺乏（我被迫多次查看代码，试图将其与我当前的项目集成），许多github问题和stackoverflow问题都没有答案

有没有可能我遗漏了什么？ 我只需要一个工具来帮助我编写API文档和测试端点

为什么招摇过市必须成为服务器逻辑的一部分？？如果我在中创建了swagger文件，然后直接将其提供给服务器，它就会中断

---

据我所知，它甚至会使服务器稍微慢一点，并迫使存在许多维护拙劣的集成：p我这里缺少什么？

我们正在努力改进Swagger的文档。当许多项目是由社区驱动的，而不是由单个组织管理时，这就有点困难了

实际上，我们试图在github上快速回答问题（我们并不总是成功），我们有自己的google小组来回答一般问题，所以我们很少关注stackoverflow

您提到的编辑器是作为Swagger 2.0工作的一部分的一个新工具，它还不是最终版本。因此，它仍然有一些bug和缺少的特性。UI也正在适应Swagger 2.0，同样的限制也适用于它

您当然不必将其与服务器集成，并且可以静态地公开文档。将其与服务器集成的优点是，如果API发生更改，则更易于维护。

您可以尝试RAML++

步骤应该是

• 使用您最喜欢的编辑器（即Atom、vim）用RAML编写API规范
• 使用ramlev验证您的RAML
• 根据API规范实现服务器逻辑
• 使用Abao验证服务器逻辑