OpenAPI Specification 的目标是为 REST API 定义一个标准的、与语言无关的接口,允许人和计算机在不访问源代码、文档或通过网络的情况下发现和理解服务的功能。 通过 OpenAPI 的正确定义,消费者可以用最简答的方式理解远程服务并与其交互,消除了调用服务时的猜测。OpenAPI不需要重写现有的API。它不需要将任何软件绑定到服务,所描述的服务甚至可能不是您的。然而,它要求在 OpenAPI Specification 的结构中描述服务的能力。不是所有的服务都可以由 OpenAPI 描述 —— 此规范并不打算涵盖 REST-ful API 的每一个可能的用例。 OpenAPI没有规定诸如设计优先或代码优先的开发过程。它通过与 REST API 建立明确的交互来促进这两种技术之一。
标签:OpenAPI
2021-02-19 21:51:51
197KB
开源项目
1