如何描述restful webService

Question

我知道两种类型的网络服务。

• SOAP webservice
• restful webservice

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

我正在处理文件。还有其他类似WSDL。

Answer 1

坏消息：

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

好消息：

但是，您可以查看以下三个选项：

1. WADL：REST的WSDL等效项（未广泛使用或接受）
2. RAML：竞争者作为记录REST和实现代码的标准方式，即WSDL等价物。
3. Swagger：记录REST服务。它首次出现时并不是真正的WSDL等价物。然而，这最近发生了变化。
4. OpenAPI：基于Swagger，它是一种自上而下的设计方式。

丑陋的新闻：

由于没有＆＃34;官方＆＃34;一些客户会对使用Swagger的RAML感到满意，但很难满足每个人的需求，但这只是一个小问题。