如何描述restful Web服务

我知道两种类型的Web服务

• SOAP Web服务
• restful Web服务

SOAP Web服务可以用WSDL描述。 所以RESTfulWebService如何描述，可以让人们知道如何调用

我在处理文件。还有类似WSDL的东西吗。

坏消息：

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

好消息是：

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

WADL:REST的WSDL等价物（未被广泛使用或接受）

RAML：竞争者，作为记录REST和实现代码的标准方式，即WSDL等价物

招摇过市：记录REST服务。当它第一次出现时，并不是真正的WSDL等价物。然而，最近情况发生了变化。请参阅下面的OpenAPI

OpenAPI：基于招摇过市，是一种自上而下的设计方法

坏消息是：

---

由于没有“官方”的方式，有些客户会对RAML感到满意，有些客户会大摇大摆，因此很难满足所有人的需求，但这是一个次要问题。

请查看OpenAPI。