网络研讨会重播:为 REST-ful API 编写文档
演讲者:Andy Wilkinson
API 的文档是使其易于理解和易于使用的重要部分。RESTful API 也不例外。在本次网络研讨会中,我们将探讨 RESTful API 文档中应包含的内容,以及同样重要的,应省略的内容。为了说明这一点,我们将查看一些现实世界中好的和坏的 API 文档示例。我们将探讨选择 Swagger 等工具来生成 API 文档所带来的一些问题和限制,最后将介绍一些更适合生成用户喜爱文档的替代方案。
了解更多关于 Spring MVC 的信息 http://projects.spring.io/spring-framework
了解更多关于 Spring REST Docs 的信息 https://github.com/wilkinsona/spring-restdocs