@axway/swagger-tools

中文文档
1.1.0发布于 2025/09/15MITCommonJS近 30 天下载 2394

使用并集成于斯瓦格2.0的各种工具.

中文使用文档
文档目录8 节
  1. 项目徽章
  2. 支持的 Swagger 版本
  3. 特征
  4. 安装
  5. 浏览器
  6. 节点.js
  7. 文档
  8. 捐款

该项目为与斯瓦格的融合和互动提供了各种工具. 这个项目尚处于初期阶段,但 应充分测试和重新使用储存库内的东西。 请访问 问题跟踪器 改为 看看我们意识到什么问题,以及我们正在研究什么特征/加强。 要不然,请随意审查一下 发布注释 以了解什么是新的和改进.

项目徽章

Join the chat at https://gitter.im/apigee-127/swagger-tools

  • 构建状态 : Build Status
  • 依赖性 : Dependencies
  • 开发者依赖性 : Dev Dependencies
  • 下载数 : NPM Downloads Per Month
  • 许可证 : License
  • 鲍尔版本 NPM Version
  • 国家预防机制版本: NPM Version

支持的 Swagger 版本

特征

  • 简单 CLI
    • 验证 Swagger 文档
    • 将 Swagger 1.2 文档转换为 Swagger 2.0
  • Schema验证:对于Swagger规格支持的文件,确保它们通过结构验证 基于 杰森·斯克马 与该规格版本有关 (浏览器和节点)
  • 语义验证: 在文件结构之上及之外验证 Swagger 文件 (浏览器和节点)
  • 连接中间软件,将相关的 Swagger 信息添加到您的请求中 (仅节点)
  • 根据 Swagger 文档连接安全处理器的中端软件 (仅节点)
  • 根据 Swagger 文档连接线程请求处理器的中间软件 (仅节点)
  • 连接服务您 Swagger 文档的中间软件 Swagger 用户界面 (仅节点)
  • 连接用于使用 Swagger 资源文档进行预路由验证的中间软件 (仅节点)
    • 根据操作的 consumes/produces 数值
    • 验证请求参数类型
    • 验证请求参数值
    • 验证响应值

安装

Swagger Tools同时可供Node.js和浏览器使用. 每种环境的安装说明如下.

浏览器

浏览器应用程序的安装可以通过 鲍尔 或下载独立的二进制.

使用鲍尔

bower install swagger-tools --save

独立的二进制

独立二进制有两种口味:

节点.js

节点Js应用程序的安装可以通过 国家预防机制。 。 。 .

npm install swagger-tools --save

如果你想用这个 swagger-tools 用于验证 Swagger 文档的可执行文件, 您可以安装 swagger 工具 全球使用:

npm install -g swagger-tools

文档

{\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}那就直接去项目吧 文档 或者直接跳转到 页:1 快速启动。 。 。 .

捐款

这个项目使用 古尔普 用来建造这样的 npm install -g gulp 一旦你复制了这个项目。 运行 gulp 输入 project root 将进行源代码检查并运行单位测试.

版本与发布记录

@axway/swagger-tools 共发布 14 个版本,首次发布于 2020/10/28;过去 12 个月发布了 0 个版本。

版本发布日期距今
1.1.0latest2025/09/151.1 年前
1.0.02022/09/194 年前
1.0.0-02022/09/154 年前
0.12.0-02022/09/134 年前
0.11.52021/12/014 年前
0.11.42021/07/165 年前

关于 @axway/swagger-tools 的常见问题

@axway/swagger-tools 是什么?

使用并集成于斯瓦格2.0的各种工具.

如何安装 @axway/swagger-tools?

在项目目录运行 npm install @axway/swagger-tools,或使用 pnpm add / yarn add / bun add。

@axway/swagger-tools 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/axway__swagger-tools 是否存在。

@axway/swagger-tools 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@axway/swagger-tools 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >= 10.16.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@axway/swagger-tools 可以商用吗?

@axway/swagger-tools 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@axway/swagger-tools 的下载量有多少?

根据 npm 官方下载统计,@axway/swagger-tools 在 2026/10/08 – 2026/11/06 这 30 天内被下载 2,394 次,日均约 80 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@axway/swagger-tools 还在维护吗?

最新版本 1.1.0 发布于 2025/09/15(1.1 年前);至今共发布 14 个版本,其中过去 12 个月发布了 0 个;首次发布于 2020/10/28。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。