首先要清楚地了解OpenAPI规范本身,让我们看看它是如何在其官方网站(https://github.com/OAI/OpenAPI-Specification)上定义的:
OpenAPI规范的目标是定义标准, REST API的语言无关接口,允许人和人 计算机,以发现和理解服务的功能 无法访问源代码,文档或通过网络 交通检查
问题: OpenAPI定义了如何在YAML或JSON中编写API文档的规范。现在问题是,它是否是唯一可以完成这项工作的规范?或者还有其他替代方案?
我在网上进行了研究,但没有得出结论。
<小时/> 注意:可能会向软件推荐此问题,但由于“规范”不能称为“软件”,我决定在stackoverflow上询问它。
答案 0 :(得分:0)
我参加了Pluralsight的在线课程,构建REST API的五个基本工具,并且可以找到以下两个工具作为OpenAPI规范的替代方案:
这些是OpenAPI规范的两种替代方案,并且在某种程度上更新,更丰富。然而,由于它们非常新,它们没有被组织很好地认可,并且工具支持是有限的。他们目前支持的大多数工具都是基于云的。