Apifox：如何设置 query 参数？

刺骨的言语ヽ痛彻心扉 2024-03-16 20:33 42阅读 0赞

在项目的开发过程中，通常会使用 `path` 来区分不同的业务数据。但有的开发项目（例如一些电商 API 文档），接口请求的 URL 是不变的，一般通过 Query 或 Header 中的参数来做区分。如果有大量的接口需要指定 Query，那么在测试接口的过程中可以进行统一设置。这样的业务需求可以通过 **[Apifox][]** 的 接口唯一标识来完成，具体操作请看下文。

### 设置接口唯一标识 ###

**[接口唯一标识][Link 1]** 在 Apifox 中被定义为`目录`层级的设置。也就是说，当你需要定义某个接口的唯一标识的时候，需要在该接口的 `父级目录` 中设置。根据你的项目需求，在`目录设置`的选项下选择你需要的唯一标识参数，然后点击保存，即可对该目录下的所有接口生效。

![2f8a6fd39fa10b35485535b44e040035.png][]

> 举个例子：一个项目中某个模块的 **[API 接口][API]**，接口中返回的业务数据通过一个叫做 action 的 query 参数来区分，所以下面我们通过`Query 参数`来定义`接口唯一标识`。

如下图所示，将下图的`接口唯一标识`选择为 `Query 参数` 后，在其右侧的输入框中输入对应的参数名，点击保存即可设置成功。

![2e6e8de24eb53412749fdf6fb1c56855.png][]

### 填写对应的唯一标识的参数值 ###

设置完 接口唯一标识后，选择该目录下的某个接口，**[Apifox][Apifox 1]** 会提示你输入参数名为 `action` 的值，填写后即可发起请求。

![3929c7f5d00f1b2d647d61ab9ae5cece.png][]

如果你需要调用该目录下的其他接口，操作方式也同上面描述一样。Apifox 会自动为你添加查询参数，省去了逐个手动添加的繁琐步骤，让你的工作更加高效！

### 总结 ###

对于接口的 path 和 Method 都一样，只通过 query 参数来做业务数据区分的接口，Apifox 的接口唯一标识可以满足你的应用需求。想要了解更多相关的知识，比如接口的导入、**[Mock数据][Mock]** 和 **[自动化测试][Link 2]** 等功能。

[Apifox]: https://apifox.com/apiskills/interface-debugging-tools/
[Link 1]: https://apifox.com/help/app/api-manage/api-unique-id/
[2f8a6fd39fa10b35485535b44e040035.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/15/dd8d1726b981418589ffc79cf03256cf.png
[API]: https://apifox.com/apiskills/understanding-apis/
[2e6e8de24eb53412749fdf6fb1c56855.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/15/ea8269c87a874d609da39e3470949bcc.png
[Apifox 1]: https://apifox.com/apiskills/apifox-auto-generates-api-docs/
[3929c7f5d00f1b2d647d61ab9ae5cece.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/15/0bebdc37a1ad4b1eab671af95897eb48.png
[Mock]: https://apifox.com/apiskills/mock-done/
[Link 2]: https://apifox.com/apiskills/what-is-automation-testing/