如何描述宁静的web服务

Question

我知道两种类型的web服务。

• SOAP web服务
• 宁静web服务

SOAP web服务可以在WSDL描述。如此宁静的webservice如何描述，可以让人们知道如何调用。

我正在处理文档。还有其他什么像WSDL。

Answer 1

坏消息：

没有官方的方式来记录REST，正如你所描述的那样。还要记住WSDL用于生成代码工件以及记录服务。

好消息：

但是你可以看看以下三个选项：

1. WADL：WSDL等同于REST（没有被广泛使用或接受）
2. 肾错构瘤：竞争者为标准文档REST和实现代码（即WSDL等效）的方式。
3. Swagger：记录REST服务。不是真正的WSDL等价物。

丑陋的新闻：

由于没有“正式”的方式有些客户将舒适与肾错构瘤有的用扬鞭，其将是很难满足大家然而，这是一个小点。