网络研讨会：记录 RESTful API

新闻 | Pieter Humphrey | 2015 年 1 月 20 日 | ...

演讲者：Andy Wilkinson, Pivotal

API 的文档是使其易于理解和易于使用的重要组成部分。 RESTful API 也不例外。在本次网络研讨会中，我们将了解 RESTful API 的文档中应包含的内容，以及同样重要的是，应省略的内容。为了说明这一点，我们将看一些好的和坏的 API 文档的真实示例。我们将了解选择像 Swagger 这样的工具来生成 API 文档的一些问题和局限性，最后看一些更适合生成用户会喜欢的文档的替代方案。