Apidog Docs
🇨🇳 简体中文
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇨🇳 简体中文
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇨🇳 简体中文
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
HomeLearning Center
Support CenterAPI ReferencesDownloadChangelog
HomeLearning Center
Support CenterAPI ReferencesDownloadChangelog
  1. 自动化测试
  • Back to home
  • 支持中心
  • Apidog 支持中心
  • 导入/导出
    • 如何将 API 数据导入 Apidog?
    • 如何在 Apidog 中导入 cURL?
    • 如何将 Postman 环境迁移到 Apidog?
    • 如何在导入 Swagger/OpenAPI 时自动对端点分组?
  • 发送请求
    • Apidog 支持 Socket.IO 吗?
    • 为什么参数值中的 “+” 会被解码为空格?
    • 如何在 Apidog 中发送请求?
    • 如何在 Apidog 中发送 graphQL 请求?
    • 如何在 Apidog 中发送 gRPC 请求?
    • 如何在 Apidog 中发送 SOAP/WebService 请求?
    • 如何在 Apidog 中发送 WebSocket 请求?
    • Apidog 是否支持 WebSocket API 中的预请求/测试脚本和断言?
    • 如何在 Apidog 中发送 SSE 请求?
    • 如何在文件夹级别添加默认头部?
    • Apidog 是否支持 gRPC API 中的预请求/测试脚本和断言?
    • ELANREFUSED.DNS 解析器错误
    • 为什么我在发送请求时会收到 “socket hang up” 错误?
    • 修复请求错误
      • 修复 read ECONNRESET 错误
      • 修复 ECONNREFUSED 错误
      • 修复 ETIMEDOUT 错误
      • 修复 ENOTFOUND: Couldn't resolve host 错误
      • 修复 ENOTFOUND: getaddrinfo ENOTFOUND www 错误
      • 修复 connect EHOSTUNREACH 错误
  • 设计 API
    • 如何在路径中使用变量?
    • 我可以将响应组件用作默认响应吗?
    • 如何查看谁修改了端点?
    • 如何在 Apidog 中批量删除端点文件夹?
    • 如何批量为端点路径添加/移除前缀?
    • 如何在 Schema 编辑器中移动属性的层级?
    • 如果一个字符串属性有多个枚举值,并且会在多个位置使用,如何在整个文档中一致地引用这个枚举?
    • 如何获取 Apidog 资源文件夹 ID?
    • 如何获取 Apidog 的资源文件夹 ID?
    • 如何在 URL 路径中使用变量?
    • 如果端点、文档或测试场景被意外删除,我该怎么办?
    • Apidog 是否支持自定义端点的请求代码?
    • 将 Swagger/OpenAPI 导入 Apidog 时,如何自动对端点分组?
    • 如何在模拟响应中生成不重复的数组数据?
    • 为什么路径中不支持输入 "#"?
  • 调试 API
    • Apidog 如何与第三方密钥管理系统集成?
    • 为什么同一个请求在其他工具(如 Postman)中可以正常工作,但在 Apidog 中不行?
    • 如何在 Apidog 中从数据库获取变量值?
    • 如何将环境从其他工具迁移到 Apidog?
    • 如何在 Apidog 中使用脚本进行断言?
    • JSONPath 只能提取数组。如何在 Apidog 中从数组中提取单个元素?
    • 当不同环境具有不同的数据库账号凭据时,如何在 Apidog 中配置数据库操作?
    • 如何在自定义脚本中获取服务基础 URL?
    • 当 API 响应过大时,为什么 Apidog 会报告超出最大 Node.js 字符串长度的错误?
    • 控制台打印的大小限制是多少?为什么打印大文件时会出现错误?
    • 如何解决 Windows 上的 DB2 数据库连接错误?
    • 为什么我在 Apidog 中连接 Oracle 数据库时会遇到错误 NJS-045?
    • 如何在 Apidog 自定义脚本中生成动态值?
    • 为什么客户端请求同一个端点可以成功,但在 Web 端调试时却出现错误:“Unable to request address”?
    • 为什么响应过大时 Apidog 会报错?
    • 如何使用 Apidog 录制端点?
    • 定义端点响应时,是否允许端点没有响应内容?
    • 如何在自定义脚本中获取服务的 baseURL?
    • 如何在 Apidog 中查看原始报文?
    • 为什么在发起请求时会看到 “Invalid URI xxx” 错误?
    • 如何在 Apidog 脚本中发起异步请求?
    • 为什么发送请求时会看到 “Couldn't resolve host” 消息?
    • 控制台打印大小限制是多少?为什么打印大文件时会报错?
    • 如何在端点请求中上传文件?
    • 如果 Apidog 崩溃或响应数据不显示,该怎么办?
    • Apidog 用于 OAuth2.0 的官方重定向 URI
  • Mock API 数据
    • 如何自动模拟 API?
    • Apidog 模拟可以做什么?
    • 如何在 Apidog 中模拟固定 API 数据?
    • 如何在 Apidog 中模拟条件数据?
    • 如何在 Apidog 中启用云端模拟?
    • 如何在 Apidog 中启用自托管模拟?
    • Apidog 支持模拟 WebSocket API 吗?
    • 为什么浏览器请求模拟端点时不返回内容?
  • 自动化测试
    • 为什么测试场景在我的本地客户端运行没有问题,但在 Apidog CLI 或运行器中运行时会出错?
    • 如何在 Apidog 中创建测试场景?
    • 如何在测试步骤之间传递数据?
    • 为什么我无法成功引用前置步骤数据?
    • 如何在 Apidog 中使用 foreach 循环?
    • 从端点/端点用例同步数据有哪些区别?
    • 如何在 Apidog 中使用测试数据?
    • 如何在 Apidog 的脚本中检索测试数据?
    • 如何在 Apidog 中批量运行测试场景?
    • 如何在 Apidog 中安排测试任务?
    • 如何在 Apidog 中运行性能测试?
    • 如何在性能测试中查看实际请求和响应?
    • 如何在 Apidog 中导出性能测试报告?
    • 如何使用数据库查询结果作为循环 API 请求的参数?
    • 在 CI/CD 期间使用 ApiDog 捕获并验证 Stripe Webhook
    • 如何解决“Error: unable to verify the first certificate on runner”错误?
    • General Runner Docker 容器 “Not Found” 错误。
    • 如何在 Apidog Web 版中为通用 Runner 设置服务器 Host?
    • 为什么定时测试场景最终显示 0 个请求?
    • 如果在 Runner 或 CLI 中找不到文件上传参数,我该怎么办?
    • 如何使用 Runner 运行包含上传文件步骤的测试场景?
    • 如何解决“Error: unable to verify the first certificate on runner”错误?
    • 当 Runner 出现问题时,如何访问和搜索 Runner 日志以识别问题?
    • 如果端点参数是上传文件,并且在 Runner 或 CLI 中找不到,我该怎么办?
    • 为什么 API 用例变更时测试步骤不会自动同步?
    • 为什么在 Markdown 文档中使用多个美元符号会导致某些内容无法正确显示?
    • 自托管 Runner 在执行任务后会在服务器上生成测试报告吗?
    • 我可以为测试场景中的请求添加统一的前置/后置处理器吗?
    • 如何在单次自动化测试运行期间保持动态值一致?
  • 发布 API 文档
    • 如何在已发布的文档中隐藏所有 Apidog 标志?
    • 当 API 规范更新时,API 文档会变化吗?
    • 如何在 Apidog 中将 API 分享给协作者?
    • 如何自定义 Apidog 文档的域名?
    • 如何在 Apidog 中创建多版本文档?
    • Apidog 中发布文档站点的共享范围
    • Apidog 中 Share Doc 列表的共享范围
    • 为什么已发布的共享文档没有显示主机名?
    • 文档用户如何在共享文档中修改 Base URL?
    • 我可以复制已发布的 Apidog 文档用于自己的项目吗?
    • 如何在 Apidog 在线文档中共享头部(例如 Token)?
    • 为什么我的团队成员找不到已发布的文档?
    • 如何修复自定义域名上的 SSL 证书过期或 Cloudflare 526 错误?
    • 自定义 SMTP 配置成功,但允许列表用户未收到 OTP 邮件
  • Markdown
    • 如何使用卡片链接到 Apidog 内的各个页面或端点?
    • 为什么在 Markdown 文档中使用多个 $ 符号时,部分内容无法正确显示?
    • 如何在 Apidog Markdown 中使用透明背景图片?
    • 如何设置 Markdown 表格的列宽?
    • 如何将内部 API、文档、数据模式或文件夹插入到 Markdown 文档中?
    • 如何在 Apidog 卡片组件中添加指向项目内文档或端点的链接?
  • 分支
    • 如何访问迭代分支?
  • 管理
    • 如何静默安装 Apidog 客户端?
    • 为什么我明明拥有管理员权限,却看到“No Permission”错误?
    • 如何查看 Runner 版本号?
    • Apidog 支持 win7 吗?
    • 为什么安装后 Apidog 显示错误“Cannot locate program entry point DiscardVirtualMemory in dynamic link library KERNEL32.dll”?
    • 订阅变更和退款
    • Web 请求有效,但应用出现 “read ECONNRESET”——为什么?
    • Windows 系统更新后为什么无法打开 Apidog?
    • 为什么 Windows 系统更新后 Apidog 无法打开
  • 计费
    • 我可以在 Apidog 中为我的团队设置单独的账单账户吗?
    • Apidog 上的团队访问与计费问题
    • 受邀团队成员无法访问 Apidog。
    • 将个人付费团队转移到组织
  • 私有化部署
    • Apidog 自托管(企业)版本中的用户和访问管理
  • Web 与客户端
    • Linux 桌面版的下载与安装
  1. 自动化测试

如何在测试步骤之间传递数据?

在自动化测试场景中,在多个请求之间传递数据非常常见。典型情况包括:
请求 1 是一个登录请求,返回一个 token;请求 2 使用此 token 请求其他数据。
请求 1 返回一个 ID;请求 2 基于此 ID 执行操作。
请求 1 返回一个列表;请求 2 使用此列表中的数据。
对于此类场景,Apidog 提供了两种不同的解决方案来处理请求之间的数据传递。你可以根据手头的具体问题选择合适的解决方案。
获取前置步骤数据:此功能允许你在后续请求中直接使用前面请求的数据。
优点是简单,无需引入额外变量。
但是,当数据需要被多次引用时,可能会稍显繁琐。
“获取前置步骤数据”功能只能在“测试”模块中使用,不能在“API”模块中使用。
使用变量:在前一个请求的预处理器中添加“提取变量”,将所需数据存储到变量中,然后在后续请求中调用此变量。
优点是在多次引用数据时很方便,但对于单次引用可能会稍微复杂一些。
变量既可以在“测试”模块中使用,也可以在“API”模块中使用。

获取前置步骤数据#

让我们考虑一个场景:请求 1 是一个登录请求并返回一个 token,请求 2 使用此 token 请求更多数据。
1
将登录请求(请求 1)添加到测试场景中。
2
将查询请求(请求 2)添加到测试场景中。
3
请求 2 的查询参数需要包含请求 1 返回的 token。点击请求 2 查询参数中 token 字段里的“魔法棒”图标 🪄,并选择“获取前置步骤数据”。
4
选择请求 1 进行数据获取,选择响应主体,并使用 JSONPath 提取请求 1 返回的 token,例如 $.token。
5
点击插入,你会看到 {{$.2.response.body.token}} 被插入为查询参数。
6
点击测试场景中的“运行”按钮,即可成功将数据从请求 1 传递到请求 2。
“获取前置步骤数据”功能仅在“测试”模块中可用,不能在“API”模块中使用。
使用“获取前置步骤数据”时,只有在整个测试场景一起运行时才能获取该值;运行单个步骤时无法访问。

使用变量语法引用前置步骤数据#

以上文中的 {{$.2.response.body.token}} 为例:
'2' 表示步骤 ID,可以在每个测试步骤中找到。
'response.body' 表示来自前置步骤的数据位置。这可以包括请求的头部、主体,或响应的头部、主体等数据。具体信息请见下方。
'token' 表示主体中下一层级的 'token' 数据。你可以使用 JSONPath 语法提取所需数据。
前置步骤数据可以用于请求的各个部分,例如请求参数、头部、身份验证等。你也可以将数据直接插入到请求主体中,如下所示。
需要注意的是,如果你需要在脚本中使用前置步骤数据,不能直接使用 {{variable}} 语法引用变量。相反,你应该使用 pm.variables.get 来引用前置步骤数据。例如:

语法参考#

类别 功能 语法示例
请求URL{{$.<step id>.request.url}}
路径参数{{$.<step id>.request.pathParam.<field name>}}
查询{{$.<step id>.request.query.<field name>}}
头部{{$.<step id>.request.header.<field name>}}
主体(表单){{$.<step id>.request.body.<field name>}}
主体(json){{$.<step id>.request.body.<field path>}}
响应主体{{$.<step id>.response.body.<field path>}}
头部{{$.<step id>.response.header.<field name>}}
Cookie{{$.<step id>.response.cookie.<field name>}}
循环元素(ForEach 循环中的数组元素){{$.<loop step id>.element.<field path>}}
索引{{$.<loop step id>.index}}

使用变量传递数据#

让我们考虑一个场景:请求 1 是一个登录请求并返回一个 token,请求 2 使用此 token 请求更多数据。
1
将登录请求(请求 1)添加到测试场景中。
2
在请求 1 的后置处理器中,添加一个“提取变量”操作,将 $.token 提取为 {{token}}。
了解更多关于提取变量的信息。
3
将查询请求(请求 2)添加到测试场景中。
4
在请求 2 的查询参数中引用变量 {{token}}。
5
点击测试场景中的“运行”按钮,即可成功将数据从请求 1 传递到请求 2。
Modified at 2026-06-09 08:55:47
Previous
如何在 Apidog 中创建测试场景?
Next
为什么我无法成功引用前置步骤数据?
Built with