提供多种语言的sdk(调用端代码:比如安卓,ios和php)
3)保证API文档和代码同步实时的更新(容易遗忘)
4)持续的性能profiling,优化
那么怎样很优雅的解决如上的问题呢?...一个比较好的方案是
beego代码注释 -> swagger.json(服务说明文档) -> swagger ui(文档和联调的web) -> swagger code generator(生成调用的客户端代码...API代码与文档同步
从go的代码注释到生成swagger.json服务说明文档,使用了beego框架的功能,其parse了代码特定格式的注释,生成了符合swaggerV2.0规范的说明文档。...://beego.me/docs/advantage/docs.md
2、web展示和调用原理:swagger-ui:
https://github.com/swagger-api/swagger-ui...silex-PHP, sinatra, slim, spring, dynamic-html, html2, html, swagger, swagger-yaml, swift4, swift3, swift, tizen