OpenAPI 规范和 Swagger

Swagger 提供最易于使用的工具，以充分利用 OpenAPI 规范 (OAS) 的所有功能。

将 OAS 添加到您的 API Swagger Inspector 让您在几秒钟内为任何 API 生成 OAS 定义 了解更多 使用 OAS 设计 API 在具有内置验证的编辑器中设计 API，以加快设计速度并减少错误 了解更多 使用 OAS 记录 API 直接从您的 OAS 定义创建开发者喜欢使用的 API 文档 了解更多 维护 OAS 定义 使用 SwaggerHub 为您的所有 API 团队提供一个中央存储库 了解更多

什么是 OpenAPI 规范？

OpenAPI 规范，以前称为 Swagger 规范，是定义 RESTful 接口的世界标准。OAS 使开发人员能够设计一个与技术无关的 API 接口，该接口构成其 API 开发和消费的基础。

了解更多

What is the OpenAPI Specification
使用 SwaggerHub 标准化 OAS

SwaggerHub 可以帮助需要设置和执行 API 样式指南并更好地协作的团队。控制您的 API 设计流程，并使用 OAS 和 SwaggerHub 帮助您的团队交付开发人员喜欢使用的 API。

了解更多

Standardize on OAS with SwaggerHub

从代码生成 OAS

如何从完全开发的 API 中获取 OpenAPI 文件？使用 Swagger Inspector，您可以从任何 API 端点自动生成定义，无需任何手动操作。生成过程少于 3 次点击，让您的开发团队充分利用定义来生成进一步的文档和 SDK。

查看 Swagger Inspector

Generating OAS From Code
OAS 和 Swagger

不能在不提及 Swagger 的情况下谈论 OAS。来自 SmartBear 的 Swagger 项目是 OAS 的原始基础，包括 Swagger 规范和 Swagger 工具。Swagger 社区正在领导构建工具，以在整个 API 生命周期中充分利用 OAS 的强大功能。

Swagger 开源工具

OAS and Swagger

API 设计资源

文章 API 设计的最佳实践 良好的 API 设计是试图完善 API 策略的团队经常讨论的话题。 网络研讨会 OpenAPI 3.0：如何使用最新的 OpenAPI 规范设计和记录 API OpenAPI 3.0，基于原始 Swagger 2.0 规范，已成为世界标准... 文档 OpenAPI 规范文档 查看 OpenAPI 规范的文档

充满信心地扩展您的 API 设计

设计

根据基于规范的标准设计和建模 API

构建

用几乎任何语言为您的 API 构建稳定、可重用的代码

文档

通过交互式 API 文档改善开发者体验

测试

在您的 API 上执行简单的功能测试，而无需开销

标准化

在您的 API 架构中设置和执行 API 样式指南