三大API设计工具对比

API设计工具中常常会拿RAML、Swagger、API-Blueprint这三种工具进行讨论比较，它们都是用来描述和辅助API开发的，只是它们之间的侧重有所不同。

社区比较

RAML:

Swagger:

API-Blueprint:

书写格式

• RAML:　YAML
• SWAGGER : JSON
• API-Blueprint : MarkDown

文档生成

• RAML:　raml2html生成html
• SWAGGER : SwaggerToHtml,Swagger2pdf
• API-Blueprint : aglio生成html

代码生成

• RAML:　https://raml.org/developers/build-your-api，支持java,node,.net,python等语言
• SWAGGER : https://swagger.io/swagger-codegen/，大部分流行语言都支持
• API-Blueprint : 没找到