导入设置

在手动导入和定时导入时，都会出现一系列的导入选项，具体如下：

Basic auth

如果你是通过 URL 导入的，有些 URL 可能使用了 Basic auth 加密。在这种情况下，只需打开 Basic auth 开关并填写用户名和密码即可。

导入到目录

支持将接口文件导入到指定的目录下。

匹配到相同的接口时

导入数据时，项目中可能已经存在之前编写的接口。如果导入的数据和已有的数据存在相同的接口，该如何处理？是直接覆盖还是以其他方式处理？

在 Apifox 中，有以下几种选项：

覆盖已有接口：当两个接口的方法和路径相同时，新文件会覆盖旧文件。

不导入：当两个接口的方法和路径相同时，新文件不会被导入。

保留两者：当两个接口的方法和路径相同时，新文件会被导入，旧文件不会被删除。

上述覆盖选项同样适用于导入 Markdown、数据模型和环境。这些元素分别通过以下方式匹配：

Markdown：通过 Markdown 文档标题匹配

数据模型：通过数据模型名称匹配

环境：通过环境名称匹配

同步更新目录

当接口匹配时，是否同步更新其所属目录 （如目录名称、目录的前/后置操作等）。

导入用例

接口用例是基于 Apifox 中接口的请求用例。

如果导入的数据源不包含接口用例 （如 OpenAPI/Swagger 格式），启用此选项会自动在接口下生成一个 “成功” 用例。

如果导入的数据源包含接口用例 （如 Apifox 格式），启用此选项会导入相应的用例。如果遇到名称匹配的用例，会将其覆盖。

添加基础路径

在早期版本的 OpenAPI （之前称为 Swagger），特别是 Swagger 2.0 中，basePath 用于表示所有 API 请求的通用基础 URL。例如，如果你有多个 API 接口如 /users、/products 等，你可以设置 basePath 为 /api/v1。因此，访问这些接口的完整 URL 就会变为 /api/v1/users、/api/v1/products 等。

启用 “添加基础路径” 选项后，导入的路径会被组装为 /api/v1/users；如果未启用，导入的路径则为 /users。

Basic auth#

导入到目录#

匹配到相同的接口时#

同步更新目录#