HTTP

借助 ArcGIS Velocity 中的 HTTP 输出,可以通过 POST、PUT 或 DELETE 请求将要素和其他文本发送到 HTTP 端点。 对于发送到输出的每个输出要素,系统将发送一个请求。

示例

分析人员将 HTTP 输出配置为将要素以自定义 JSON 格式发送到指定的 Webhook。

用法说明

使用 HTTP 输出时,请谨记以下信息:

  • 在请求正文中发送 JSON 时,请使用 Text() Arcade 表达式将 JSON 括起来,以正确地格式化 JSON。
  • 使用 HTTP 输出时,了解数据的速度至关重要。 发送到输出的每个记录都将生成单独的请求。 由此可能会快速使 web 服务器的容量或速率限制设置过载。 将 HTTP 输出用于不经常发生的事件。
  • 在使用 OAuth 身份验证时:
    • HTTP 输出类型支持使用 OAuth 2.0 进行遵循客户端凭据或密码授予类型的 HTTP 端点的身份验证。 这些 OAuth 授权类型遵循的方案包括配置 HTTP 请求以获取访问令牌。 在配置访问令牌请求期间,系统将提示您从 OAuth 授权服务器的响应中识别访问令牌和有效期 JSON 密钥字段。 如果选择了有效期,则必须定义有效期类型(持续时间或时间戳)和单位。
    • 当返回数据请求的配置时,必须使用 $accessToken 全局变量来定义将使用访问令牌的位置。 这通常是在带有值 Bearer $accessTokenAuthorization 自定义标题中。

参数

以下是 HTTP 输出的参数:

参数描述数据类型

URL

用于发送输出请求的 URL。

字符串

HTTP 方法

请求的 HTTP 方法。 选项包括 POSTPUTDELETE

字符串

POST 正文

JSON Arcade 表达式。

Arcade 表达式

内容类型

发出请求的内容类型标题。

  • 纯文本text/plain
  • JSONapplication/json
  • CSVtext/csv
  • XMLtext/xml

字符串

身份验证类型

选择无身份验证、基本身份验证或 OAuth 身份验证。

如果配置了基本身份验证,将显示用于输入用户名和密码的附加字段。

如果配置了 OAuth 身份验证,则会出现一个需要配置的弹出窗口:

  • 访问令牌端点
  • HTTP 方法
  • URL 参数
  • 自定义标题

指定上述内容后,系统将测试连接,您必须单击以识别 JSON 响应中的访问令牌。

各种参数

URL 参数

要包含在发送到指定网站的 HTTP 请求 URL 中的可选 URL 参数。

虽然也可以在以上 URL 参数中设置参数,但是在此处作为单独参数输入的 URL 参数将覆盖 URL 参数中提供的任何匹配参数。

在此参数中定义的 URL 参数将始终使用 URL 编码。

键值对

自定义标题

发送到指定网站的 HTTP 请求中将包含可选的自定义标题。 例如,自定义标题可用于指定第三方 API 密钥或身份验证标题。

键值对

其他日志记录

可以选择对原始 HTTP 请求和 Velocity 发出的请求启用日志记录。

注:

仅当进行故障排除时,才应启用此参数,并且应在完成故障排除时禁用。 在启用参数后启动分析,调试级别日志即会出现在分析日志页面上。 如有必要,请联系 Esri 技术支持以获得故障排除方面的帮助。

布尔

注意事项和限制

下面是使用 HTTP 输出时的注意事项和限制:

  • 在使用 OAuth 身份验证时:
    • 在创建输出时,系统会向授权服务器和相关数据端点发送多次请求。 一些 API 对某些请求实施限速,这可能会影响输出创建。
    • 出于安全原因,在编辑身份验证参数时,必须重新配置访问令牌请求 POST 正文。
  • 必须可以通过 Internet 从外部访问 web 服务器。