调试 API
Apidog 如何与第三方密钥管理系统集成？
我们正在开发与 Azure Key Vault、HashiCorp Vault 和 AWS Secrets Manager 的集成，预计将于 2024 年 12 月发布。
为什么同一个请求在其他工具（如 Postman）中可以正常工作，但在 Apidog 中不行？
如果请求完全相同，那么无论使用哪种工具，响应也应该完全相同。如果你得到的响应不同，可以切换到“实际请求”标签页，并与你在其他工具中发送的请求进行对比，以找出差异。
如何在 Apidog 中从数据库获取变量值？
Apidog 提供了一项独特功能：连接到数据库以检索数据，将其设置为变量，并在请求中使用。步骤如下：
在 **Run** 选项卡（DESIGN 模式）或 **Request** 选项卡（DEBUG 模式）中，导航到后置处理器。
将鼠标悬停在“Add PostPro...
如何将环境从其他工具迁移到 Apidog？
在 Apidog 中，变量的初始值会在团队内同步，而当前值仅存储在本地。这意味着，当你在另一台电脑上使用 Apidog 时，将无法访问之前使用过的当前值。
因此，Apidog 提供了迁移环境的功能。 你可以将环境中的服务和变量导出为 JSON 文件，然后在另一台电脑上导入。步骤如下： 在环境...
如何在 Apidog 中使用脚本进行断言？
在 Apidog 中，你可以使用 pm.test 语法通过脚本创建断言。Apidog 兼容 Postman 脚本，允许用户无缝利用现有脚本。
:::highlight purple了解更多关于脚本的信息。:::
JSONPath 只能提取数组。如何在 Apidog 中从数组中提取单个元素？
JSON 是最常用的响应数据格式，而 JSONPath 是一种广泛用于在 JSON 结构中提取数据的语法。Apidog 提供了一个可视化的 JSONPath 提取工具，用于简化 JSONPath 表达式的编写过程。以下是如何有效使用该工具的指南：
点击位于 JSONPath 输入框右侧的 ...
当不同环境具有不同的数据库账号凭据时，如何在 Apidog 中配置数据库操作？
在使用测试环境、生产环境等多个环境时，它们通常会配置不同的数据库。如果你在工作流中使用数据库操作，这意味着这些操作需要随着环境切换而切换。
在这种情况下，你可以在 Apidog 的“数据库连接”设置中配置多个数据库连接。通过为每个环境设置数据库连接，可以确保当你使用右上角的下拉菜单在环境之间切换时，...
如何在自定义脚本中获取服务基础 URL？
Apidog 提供了 pm.request.getBaseUrl()，用于检索当前端点的基础 URL。
建议使用此方法，而不是 pm.environment.get('BASE_URL')，因为如果端点未使用默认服务器，后者可能无法返回正确的基础 URL。
有关服务和基础 URL 的...
当 API 响应过大时，为什么 Apidog 会报告超出最大 Node.js 字符串长度的错误？
当处理过大的 API 响应时，Apidog 的前端可能会遇到与 Node.js 字符串长度限制相关的问题。Node.js 使用 V8 引擎，而 V8 对单个字符串的长度有限制，通常约为 337MB。当响应大小超过此限制时，可能会导致内存不足或字符串处理错误，从而导致 Apidog 报告已超出最大 N...
控制台打印的大小限制是多少？为什么打印大文件时会出现错误？
Apidog 的控制台打印大小限制为 1024 * 1024 字节（1MB）。这是 Node.js 的限制，目前 Apidog 不支持配置此限制。如果打印的文件内容超过此限制，将会发生错误。
如何解决 Windows 上的 DB2 数据库连接错误？
如果你在 Apidog 中连接 DB2 数据库时遇到错误 Error: The specified module could not be found.，通常是由于缺少环境变量。你可以通过配置以下环境变量来解决此问题：
配置 PATH 环境变量：将 <Apidog Installation ...
为什么我在 Apidog 中连接 Oracle 数据库时会遇到错误 NJS-045？
“NJS-045: cannot load a node-oracledb binary for Node.js 18.18.2 (darwin arm64)”
出现此问题是因为 Oracle 目前对 ARM64 架构存在兼容性限制。因此，oracledb 驱动目前不支持 ARM64。
如何在 Apidog 自定义脚本中生成动态值？
PM Script API Apidog 支持在自定义脚本中生成动态值，使用 pm.variables.replaceInAsync(variableName:String):function 方法将字符串中的“动态值表达式”替换为实际值。该函数返回一个 Promise，调用时必须添加 await。...
为什么客户端请求同一个端点可以成功，但在 Web 端调试时却出现错误：“Unable to request address”？
在线文档或 Web 调试期间无法请求地址？
当你尝试在 Apidog 共享的文档中调试端点时，出现错误 “Unable to request the address”，可能原因如下：
浏览器证书问题：如果你的请求是 HTTPS，端点可能会在请求期间重定向到 443 端口。由于客户端可以设置为忽略证...
为什么响应过大时 Apidog 会报错？
当处理超大的接口响应时，Apidog 的前端可能会遇到与 Node.js 字符串长度限制相关的问题。Node.js 使用 V8 引擎，该引擎对单个字符串的长度有限制，通常约为 337MB。当响应大小超过此限制时，可能会导致内存不足或字符串处理错误。
如何使用 Apidog 录制端点？
Apidog 目前暂不支持自动录制端点功能，但未来计划支持该功能。
目前有一种快速录制的方法：在浏览器中测试端点时打开 DevTools。操作完成后，右键导出 HAR 文件，并一键导入到 Apidog 中。创建一个测试场景并导入所有请求，即可随时回放。有关如何导入 HAR 文件的详细信息，请参阅导入...
定义端点响应时，是否允许端点没有响应内容？
如果升级到最新版本，端点定义支持将响应的内容格式设置为 No-Content，这意味着没有响应主体。
如何在自定义脚本中获取服务的 baseURL？
Apidog 提供了 pm.request.getBaseUrl() 方法，用于获取当前端点的 baseURL。
建议使用上述方法，而不是 pm.environment.get('BASE_URL')，因为如果端点未使用默认服务，后者可能无法返回正确的 baseURL。
此外，你可以...
如何在 Apidog 中查看原始报文？
Apidog 不需要打印到控制台，返回消息中有一个 “Actual Request” 标签页，你可以在该标签页中直接查看原始请求报文。
![图片.png](https://api.apidog.com/api/v1/projects/544525/resources/352515/image-pr...
为什么在发起请求时会看到 “Invalid URI xxx” 错误？
检查端点是否关联到了一个 Base URL 为空的服务。
如果你正在使用继承（例如父文件夹），请确保父文件夹和根文件夹都已正确配置其 Base URL（即不为空）。你可以阅读 环境与变量
验证 Base URL 是否使用变量定义。
如果 Base URL 使用了变量，请确保对应的全局变量或环境变...
如何在 Apidog 脚本中发起异步请求？
Apidog 支持在自 定义脚本中使用 pm.sendRequest 函数来发起异步请求。详情请参阅 Apidog Postman 脚本参考。
为什么发送请求时会看到 “Couldn't resolve host” 消息？
需要检查端点的 Base URL 是否缺少 “/”。
如果 API 的 URL 包含环境变量，请检查该变量的值是否不正确。
控制台打印大小限制是多少？为什么打印大文件时会报错？
Apigog 的控制台打印大小限制为 1024 * 1024字节（1MB）。这是 Node.js 的限制，目前 Apidog 不支持对此限制进行配置修改。如果打印文件的内容过大并超过此限制，将会报错。
如何在端点请求 中上传文件？
如果你需要为 API 请求上传文件，需要将请求主体切换为 form-data 格式，并将对应字段设置为文件类型，然后即可上传文件。
如果 Apidog 崩溃或响应数据不显示，该怎么办？
发生了什么？
这种情况非常少见，但你可能偶尔会遇到 Apidog 崩溃；当你重新打开它时，API 调用的响应数据可能不会显示。相反，你可能会看到一个加载动画，随后出现一条消息：“点击发送以获取响应。” 我们知道这可能会让人烦恼，我们会帮助你让一切重新顺畅运行！
![图片.png](https...
Apidog 用于 OAuth2.0 的官方重定向 URI
Q: Apidog 用于 OAuth2.0 认证的官方重定向 URI 是什么？
A：在 Apidog 中为你的 API 设置 OAuth2.0 认证时，你可能需要在授权服务器或客户端设置中注册一个官方重定向 URI。这可确保 OAuth 流程能够成功完成，并且 Apidog 能够在授权后接收访问令牌...