【区分】swagger和openapi，到底区别在哪儿？

有了统一的API接口平台，不管对内还是对外，都能更好做到：统一接口开发、统一接口管理、统一接口开放服务。

统一接口开发：包括API接口的命名、分类、格式、接口文档、接口变更记录、接口发布、接口测试、接口日记等，都要统一风格、规范标准和约束。

统一接口管理：包括API接口的升级、增加参数、部署、性能监控、错误日志，同时结合开发、测试、运维、文档等形成整套的研发体系和闭环。

统一接口开放服务：主要是针对接口的IP白名单、接口申请、接口调用权限、接口次数限制、接口流量统计，以及开发者账号的开通注册，以应用的创建和审核。解决要不要对接口收费，怎么收费和进行服务、售后支持。

Open API 即开放 API，也称开放平台。所谓的开放 API（OpenAPI）是服务型网站常见的一种应用，网站的服务商将自己的网站服务封装成一系列API（Application Programming Interface，应用编程接口）开放出去，供第三方开发者使用，这种行为就叫做开放网站的 API，所开放的 API 就被称作 OpenAPI（开放 API ）。

openapi规范

三丰，公众号：soft张三丰【了解】API优先与openapi规范，你都了解吗？

Swagger 是什么？

Swagger 是一个规范和完整的框架，用于生成、描述、调用和可视化 RESTful 风格的 Web 服务。

总体目标是使客户端和文件系统作为服务器以同样的速度来更新。文件的方法、参数和模型紧密集成到服务器端的代码，允许 API 来始终保持同步。Swagger 让部署管理和使用功能强大的 API 从未如此简单。

理解差异的最简单方法

OpenAPI =规范 

Swagger =实现规范的工具

OpenAPI是规范的正式名称。该规范的开发是由OpenAPI Initiative推动的，该倡议涉及更多来自技术领域不同领域的30个组织-包括Microsoft，Google，IBM和CapitalOne。领导Swagger工具开发的公司Smartbear Software也是OpenAPI Initiative的成员，帮助领导了规范的发展。

Swagger是与用于实现OpenAPI规范的一些最著名，使用最广泛的工具相关联的名称。Swagger工具集包括开源工具，免费工具和商业工具的组合，可在API生命周期的不同阶段使用。

这些工具包括：

Swagger编辑器：使用 Swagger编辑器，您可以在浏览器内的YAML中编辑OpenAPI规范，并实时预览文档。

Swagger UI：Swagger UI是HTML，Javascript和CSS资产的集合，这些资产从符合OAS的API动态生成精美的文档。

Swagger Codegen：允许在给定OpenAPI规范的情况下自动生成API客户端库（SDK生成），服务器存根和文档。

Swagger Parser：用于从Java解析OpenAPI定义的独立库。

Swagger Core：Java相关的库，用于创建，使用和使用OpenAPI定义。

Swagger Inspector（免费）：API测试工具，可让您验证API并从现有API生成OpenAPI定义。

SwaggerHub（免费和商业）：API设计和文档，为使用OpenAPI的团队而构建。

由于Swagger工具是由参与创建原始Swagger规范的团队开发的，因此通常仍将这些工具视为该规范的代名词。但是Swagger工具并不是唯一可用于实现OpenAPI规范的工具。有各种各样的API设计，文档，测试，管理和监视解决方案都支持该规范的2.0版，

OpenAPI和Swagger社区

尽管为OpenAPI做出贡献的人们与为Swagger工具做出贡献的人们之间总是会存在重叠，但是这两个社区是彼此独立的。

OpenAPI Initiative是一个开放的，与供应商无关的组织，欢迎任何想要帮助发展或利用其API开发中的规范的人参与。邀请组织加入不断增加的对规范做出贡献的成员列表，并且欢迎个人参加，在GitHub上分享想法和反馈，或参加每月在世界各地举行的许多OAS聚会之一。在此处了解有关如何做出贡献的更多信息。

Swagger工具拥有自己的社区，致力于帮助改进某些现有Swagger项目，并引入新的想法和功能要求。Swagger社区是由SmartBear Software的团队培育的，该团队投资于开源Swagger工具的开发，但也受到世界各地成千上万Swagger用户的贡献的推动。