Swagger 接口分组配置教程

当项目中存在多个模块或多个版本的接口时，使用 Swagger 接口分组功能可以更好地组织和管理这些接口。

Swagger enum 使用详解

enum 是 Swagger 规范中用来定义枚举类型的一种方式。它允许开发者在 API 文档中明确列出该接口的参数、返回值或请求体中可接受的枚举值。

如何将 Swagger 导入 Postman

将 Swagger 中的 API 定义导入到 Postman 中去，这样就可以利用 Postman 更强大的测试功能来测试 Swagger 定义的接口。

Swagger 中添加 Bearer token 验证

Bearer token 验证是一种常用的身份验证方式，用于保护 API 的访问权限。在 Swagger 中添加 Bearer token 可以增加 API 安全性，并限制只有具有有效访问令牌的用户才能访问受保护的资源。

Swagger Basic Authentication（身份验证）配置

Swagger Basic Authentication（身份验证）是一种用于保护 API 接口的基本身份验证方法。它通过在每个请求中包含基本认证头部，即包含 Base64 编码的用户名和密码，来验证用户的身份。

Swagger basepath 用法及常见问题详解

basepath 是 Swagger 用来指定 API 的基本路径的一个选项。它用于设置 API 的基本路径，在使用 Swagger 编写 API 文档时，通过设置 basepath，可以统一设置 API 的前缀路径，方便 API 管理和调用。

Swagger Array 使用详解

Swagger 中对 Array 类型的支持允许开发者明确定义和描述 API 中涉及的数组类型参数和响应。通过指定数组元素的类型、约束和格式，开发者可以清晰地描述 API 的使用方式和预期输出。

Swagger annotations 如何使用？详解 Swagger 注解

Swagger Annotations 是 Swagger 框架提供的一组用于描述和定义 API 文档的注解。这些注解通过标识代码中的相关部分，让 Swagger 能够解析并生成 API 文档。

Swagger additionalProperties 如何使用

在 Swagger 中，additionalProperties 是一个用于描述模型中包含未在属性列表中定义的额外属性的选项。它允许接受任意的一个或多个键值对。它的作用是为了在模型定义中包含未知或动态属性。

Swagger API 未授权访问漏洞问题怎么解决

未授权访问漏洞是指未受保护的资源或功能可以被未经授权的用户访问。在 Swagger API 中，如果没有适当的访问控制措施，攻击者可以通过查看 Swagger 文档中的 API 端点和参数，发现和利用未受保护的 API。

Swagger allOf 的用法

Swagger allof 是 Swagger 规范的一个扩展，它允许我们在定义数据结构时，引用其他已定义的数据模型，以创建更复杂的数据结构。使用 allof 可以实现数据模型的继承和组合，这减少了冗余的定义，并提高了代码的可维护性和可读性。

YApi和Swagger的完美结合：如何高效管理API文档和接口数据

本文将介绍如何使用 YApi 和 Swagger 实现 API 文档自动生成、帮助你优化 API 设计和开发流程。

YApi与Swagger的无缝衔接：如何高效导入Swagger数据

本文将介绍如何在 YApi 中快速导入 Swagger 数据，帮助你更好地管理 API 文档和接口数据。

2025 年度 10 个好用的 API 管理工具

本文将对市面上好用的 API 管理工具进行对比分类，帮助你做出选择。包括 Postman、SwaggerHub、Apifox 等等。

2025 年 10 个好用的 Swagger 替代工具推荐

Swagger 是一款优秀的工具，规范化了 API 的设计、文档编写和测试流程。本文推荐 10 个好用的 Swagger 替代工具，包括Apifox、Postman、RapidAPI、Apiary等。

Apifox 和 Swagger ，2025 年对比分析

本文想和大家分享一下关于 Apifox 和 Swagger 这两款主流 API 开发工具的深度对比分析。