API设计：Swagger, Blueprint和RAML

Swagger Swagger与RAML相比，RAML解决的问题是设计阶段的问题，而Swagger则是侧重解决现有API的文档问题，它们最大的不一样是RAML须要单独维护一套文档，而Swagger则是经过一套反射机制从代码中生成文档，而且借助ajax能够直接在文档中对API进行交互。由于代码与文档是捆绑的因此在迭代代码的时候，就能方便的将文档也更新了。不会出现随着项目推移代码与文档不匹配的问题。另

>>阅读原文<<