Swagger Core <img src="https://yellow-cdn.veclightyear.com/0a4dffa0/c3a8e639-625b-4020-ad6f-63ce89d82ab4.png" height="50" align="right">

注意： 如果你正在寻找 Swagger Core 1.5.X 和 OpenAPI 2.0，请参考 1.5 分支。

注意： 自 2.1.7 版本起，Swagger Core 也支持 Jakarta 命名空间。有一组带有 -jakarta 后缀的并行构件，提供与无后缀（即：javax）构件相同的功能。 详情请参阅 Wiki。

注意： 自 2.2.0 版本起，Swagger Core 支持 OpenAPI 3.1；详情请参阅此页面

Swagger Core 是 OpenAPI 规范的 Java 实现。当前版本支持 JAX-RS2（javax 和 jakarta 命名空间）。

开始使用 Swagger Core！

查看Swagger Core 入门指南，了解如何开始将 Swagger 添加到你的 API 中。

查看 Wiki！

GitHub wiki 包含文档、示例、贡献等内容。从那里开始吧。

兼容性

OpenAPI 规范自 2010 年首次创建以来经历了多次修订。Swagger Core 项目与 OpenAPI 规范有以下兼容性：

变更历史

如果您对 Swagger 和 Swagger Core 框架的变更历史感兴趣，请点击这里查看。

前提条件

您需要在您的 $PATH 中安装并可用以下内容：

• Java 11
• Apache maven 3.0.4 或更高版本
• Jackson 2.4.5 或更高版本

从源代码构建（当前版本 2.2.23-SNAPSHOT）

# 首次本地构建
mvn -N

后续构建：

mvn install

这将构建所有模块。

当然，如果您不想在本地构建，可以从 Maven 中央仓库获取构件：

https://repo1.maven.org/maven2/io/swagger/core/

示例应用

示例已移至新的仓库，包含各种集成和配置。

安全联系方式

请通过发送电子邮件至 security@swagger.io 披露任何安全相关问题或漏洞，而不要使用公共问题追踪器。