rest - 您如何记录REST API？

Question

您如何记录REST API？不仅是关于资源是什么的文档，而且实际上是在请求中发送的数据是什么，以及在响应中发回的数据是什么。知道某事希望发送XML并返回XML并没有多大用处；或JASN;管他呢。您如何记录请求中发送的数据和响应中发送回的数据？

到目前为止，我能找到的最好的是Enunciate工具，您可以在其中记录REST API和数据元素。是说出适合此工具的类型，我是否错过了其他应提供的工具？

我的REST API的使用者可以使用任何语言的python，Java，.NET等

Answer 1

我为我的项目决定的方法是Enunciate。似乎是REST API文档的事实上的标准。