1.描述语言选择

Swagger.io 首选

Apigee发布了API Studio——用来创建、测试和共享API的免费在线工具。 http://apistudio.io/

API Studio基于知名的Swagger Editor——使用YAML格式设计API的工具。 https://github.com/swagger-api/swagger-editor

RAML1.0 参考

2.开发框架选择

PHP（Laravel 方向）

http://packalyst.com/packages/package/latrell/swagger Swagger for Laravel 5 This package combines swagger-php and swagger-ui into one Laravel-friendly package. 该包整合了swagger-php与swagger-ui，与Laravel5.x兼容，实现了API的自动测试及文档的自动化流程

Golang（GOA框架）

http://goa.design/ https://github.com/raphael/goa 基于Go语言的HTTP微服务框架，名为 “goa” 。这一框架允许开发者通过 领域特定语言 （DSL）定义服务的API，并且通过自动代码生成功能创建“样板”式的服务端和客户端代码以及文档。

Golang（beego框架）