如何记录REST API调用的xml结构？

Question

与作为WSDL的SOAP一样，它允许您生成有助于创建请求的代码，REST中是否有任何机制允许您记录REST API调用的有效负载或响应？

提供REST API的大多数服务似乎都提供了解释结构的示例。 REST API的最佳实践是什么。

Answer 1

如果你要返回xml，你可以简单地提供一个xsd。还有wadl，一些框架会自动生成。

Answer 2

我发现最佳做法是提供样本（或样本链接）来解释结构。因此，针对您的API工作的开发人员无需额外的工具或工作流即可了解如何与服务的每个部分进行交互。