OpenAPI规范以外的规范，用于记录宁静的API

Question

首先要明确了解OpenAPI规范本身，让我们看看如何在其官方网站（ https://github.com/OAI/OpenAPI-Specification ）上对其进行定义：

OpenAPI规范的目标是为REST API定义一个与语言无关的标准接口，使人类和计算机都可以发现和理解服务的功能，而无需访问源代码，文档或通过网络流量检查

问： OpenAPI定义了有关如何用YAML或JSON编写API文档的规范。 现在出现的问题是，它是否是唯一可以完成这项工作的规范？ 还是有其他替代品呢？

我在网上进行了研究，但没有得出结论。

---

注意：可能会向软件推荐询问此问题，但是由于“规格”不能称为“软件”，因此我决定在stackoverflow上进行询问。

Answer 1

我上了Pluralsight的在线课程，这是构建REST API的五个基本工具 ，并且可以找到以下两个工具来替代OpenAPI规范：

• RAML（ http://raml.org/ ）
• API蓝图（ https://apiblueprint.org/ ）

这是OpenAPI规范的两个替代方案，在某种程度上它们的规范越来越新。 但是，由于它们很新，因此未被组织很好地认可，并且工具支持有限。 他们目前支持的大多数工具都是基于云的。