在 手动导入 和 定时导入 期间，你都可以使用 导入选项 自定义数据的处理方式。通用设置#
目标与目的地#
| 选项 | 描述 |
|---|
| Basic Auth | 用于需要用户名/密码认证的 URL 导入。 |
| 目标分支 | 选择要将数据导入到的特定分支（默认为 main）。 |
| 导入到 | 选择导入到现有文件夹/模块，或创建新的文件夹/模块。 |
| 自动生成用例 | 如果启用，当规范缺少示例时，Apidog 会自动创建一个“成功”测试用例。 |
环境导入#
如果你的 OpenAPI/Swagger 文件定义了多个服务器，请启用 将服务器导入为环境，以便在 Apidog 中自动创建匹配的环境。安全与命名#
安全方案#
控制如何处理 OpenAPI 中的 securitySchemes。全局认证：将规范的全局安全配置映射到 Apidog 中根文件夹的认证。
未定义认证：决定没有特定安全配置的端点的行为（例如，“继承自父级”或“无认证”）。
端点命名#
如果某个端点缺少描述性的 Summary 字段，你可以选择名称的备用来源：冲突解决#
当导入的数据与现有数据匹配时（基于方法和路径），使用以下规则来决定处理结果。端点冲突#
| 策略 | 行为 |
|---|
| 覆盖 | 使用新数据完全替换旧端点。 |
| 保留两者 | 创建重复项；新旧端点并排同时存在。 |
| 忽略 | 跳过新端点；保持旧端点不变。 |
| 合并 | 智能更新：在更新定义的同时，保留名称、模拟规则和描述等手动更改。 |
| 覆盖所选项 | 仅更新你选择的特定字段，保留其他字段。 |
其他资源（Schemas / 文档）#
对于 Markdown 文档、Schemas 和 Components，也适用类似的 覆盖 与 合并 选项。高级同步逻辑#
文件夹同步#
当导入的端点与项目中的现有端点匹配，但它们的文件夹位置不同时：保留现有文件夹：忽略导入文件中的文件夹路径。该端点将保留在 Apidog 中当前的文件夹内。
更新端点文件夹：将端点移动到导入文件中定义的文件夹结构中。
资源清理#
决定项目中已存在但在新导入文件中缺失的资源会发生什么。删除（同步）：移除新文件中不存在的任何资源。为保持规范的精确镜像，请谨慎使用。
Modified at 2026-06-09 08:55:47
