Web 请求 - 测试版

使用 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
    • 类型：这需要匹配正在读取的值的格式，以便可以在未来的阶段应用正确的筛选器/行为。
    • 映射标签：这是字段的友好名称，它将显示在后续阶段的令牌选择器和筛选器上。

选择映射数组属性后，点击测试映射以根据示例回应测试映射，这可确保映射正确。