---
title: Web 请求 - 测试版
slug: neurons/help/zh_cn/web
createdAt: 2026-09-07T07:01:34.578Z
---

使用 Web 请求阶段检索要在机器人中使用的信息，或推动外部系统中的更改。 该阶段从 Ivanti Neurons 平台执行，并且通过该阶段的每个设备都会运行一次。 它可以与第 3 方 REST API 交互，并支持未经身份验证和经过身份验证的 API。

## 如何配置 Web 请求阶段

1. 在“创建机器人”页面上，向机器人添加 **Web 请求**阶段，然后打开**阶段设置**。
2. 如果 Web 请求需要身份验证，请从**选择凭据**下拉列表中选择凭据。 如果您需要创建新凭据，请点击**添加凭据**打开**凭据存储**。 目前支持基本 API 和 API 密钥身份验证。 如果不需要凭据，请保留默认设置**无身份验证**。
3. 如果您想查看自动生成的标题，可在**标题**下将**显示自动生成的标题**切换至**开**。 标头符合目标 API 要求，有关更多详细信息，请参阅第 3 方文档。
   - **键**：输入 Web 请求的标头键。
   - **键**：输入 Web 请求的标头值。
4. 选择**方法**。 这是将用于访问目标 API 的 HTTP 方法。 支持的方法有：GET、POST、PUT、PATCH 和 DELETE。
5. 输入 API **地址**。 该地址必须可通过互联网访问。
   如果您从另一个阶段或机器人输入传递值，并且目标 API 接受 JSON 负载，请点击**编辑 JSON 正文**打开 Json 编辑器。 选择要包含的值（Web 请求阶段必须连接到任何先前的阶段才能传递信息）。
6. 选择适当的**输出模式**以反映来自 API 的回应。 如果您选择 GET 的 HTTP 方法，最常见的将是 JSON。
7. 点击**测试并获取回应**以立即调用 API。
   如果 JSON 正文包含早期阶段的变量，系统将提示您输入示例数据。
8. **示例回应**通过测试和获取回应操作填充。
   验证回应后，您可以确定结果是单一的（每个端点的字段均为唯一值）还是数组（每个端点的给定字段有多个值）。
9. 如果结果是数组，则需要打开**映射数组**。
   当阶段处于映射数组模式时，阶段将显示“多个”徽章，这意味着要在大多数其他阶段使用结果，您将需要使用“For-each”块来执行每个结果的内容。
   - 输入**数组路径**。
10. 一旦**映射数组**切换为**开**，完成以下**字段映射**属性：
    - **数组元素内部的路径**：JSON 回应中对象的路径。 这可能只是其本身的名称，但如果对象是嵌套的，则需要用点语法表示路径，例如` level1.level2.myfield`
      **单一示例：**
      `{"configuration": {startup_events": {"updates": "some value"}}}`
      更新路径为：configuration.startup\_events.updates
      **数组示例：**
      `{"users": [{display_info": {"name": "John"}}]}`
      更新路径为：users
      数组内路径为：display\_info.name
    - **类型**：这需要匹配正在读取的值的格式，以便可以在未来的阶段应用正确的筛选器/行为。
    - **映射标签**：这是字段的友好名称，它将显示在后续阶段的令牌选择器和筛选器上。

:::Paragraph{indent="1"}
选择映射数组属性后，点击**测试映射**以根据示例回应测试映射，这可确保映射正确。
:::
