Rest API蓝图和招摇过市的区别是什么？

我正在尝试以云本地方式开发应用程序。我正在尝试我的应用程序的API第一次设计

---

我应该使用哪种API文档工具？哪一个更适合API优先合同？确切地说，哪一个适合哪一个

我认为这两种格式都适用于API优先的方法，所以这是一个品味问题（降价与基于yaml/json）或工具限制问题

您可以在上阅读简要摘要

这两种格式都是开源的，都有很好的社区和工具 围绕着他们建造

• Swagger是YAML（或JSON）格式，重点是易于解析和修改 具有广泛的扩展和集成选项
• API蓝图来了 语法接近Markdown、MSON，完全支持所有Apiary 工具和开源工具

两者都应该允许您描述 广泛的API体系结构，采用设计优先的方法。大摇大摆 随附从代码生成描述的工具。API蓝图 语法使描述超媒体/RESTAPI更容易

如果您不熟悉API描述世界，我们建议您从 API蓝图