OpenAPISpecification 的目标是为RESTAPI定义一个标准的、与语言无关的接口,允许人和计算机在不访问源代码、文档或通过网络的情况下发现和理解服务的功能。通过OpenAPI的正确定义,消费者可以用最简答的方式理解远程服务并与其交互,消除了调用服务时的猜测。OpenAPI不需要重写现有的API。它不需要将任何软件绑定到服务,所描述的服务甚至可能不是您的。然而,它要求在OpenAPISpecification 的结构中描述服务的能力。不是所有的服务都可以由OpenAPI描述——此规范并不打算涵盖REST-fulAPI的每一个可能的用例。Open