【发布时间】：2015-08-17 12:08:28
【问题描述】：
在 SOAP 中，我们必须向 Client 提供 wsdl。但是在休息时，我们必须与客户分享什么？根据我对纯宁静 Web 服务的想法，我们不需要任何文档（wadl）那么我们将给客户什么？
【问题讨论】：
-
其余服务的API文档。
标签： java rest jakarta-ee wadl
【发布时间】：2015-08-17 12:08:28
【问题描述】：
您需要为您的 API 创建/生成 API 文档并提供给客户。
您可以使用工具来执行此操作，此链接可能会对您有所帮助：automated-documentation-rest-apis
【讨论】：
-
这意味着我们需要 wadl 。但是一个纯粹的宁静的网络服务不需要任何文档
-
@PRIYANKSINHA .. 是的，WADL 可能会有所帮助，但文档更易于自我解释，并且可能带有示例。 API 文档比 WADL 更容易阅读/理解。
-
@PRIYANKSINHA .. 例如你可以看看Twitter API documentation
-
@PRIYANKSINHA .. 这是解决您的问题还是您对此有更多了解？
-
感谢您的回复。根据您与自我解释和示例的文档共享比 WADL 更好。