網路研討會：RESTful API 文件

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

演講者：Andy Wilkinson, Pivotal

API 的文件是使其易於理解和使用至關重要的一部分。RESTful API 也不例外。在本次網路研討會中，我們將探討 RESTful API 文件應包含的內容，以及同樣重要的，應省略的內容。為了說明這一點，我們將透過一些真實世界的優秀和糟糕 API 文件示例進行分析。我們將探討使用 Swagger 等工具生成 API 文件時存在的一些問題和侷限性，並最終討論一些更適合生成使用者喜愛的文件的替代方案。