借助 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 $accessToken 的 Authorization 自定义标题中。
参数
以下是 HTTP 输出的参数:
参数 | 描述 | 数据类型 |
---|---|---|
URL | 用于发送输出请求的 URL。 | 字符串 |
HTTP 方法 | 请求的 HTTP 方法。 选项包括 POST、PUT 和 DELETE | 字符串 |
POST 正文 | JSON Arcade 表达式。 | Arcade 表达式 |
内容类型 | 发出请求的内容类型标题。
| 字符串 |
身份验证类型 | 选择无身份验证、基本身份验证或 OAuth 身份验证。 如果配置了基本身份验证,将显示用于输入用户名和密码的附加字段。 如果配置了 OAuth 身份验证,则会出现一个需要配置的弹出窗口:
指定上述内容后,系统将测试连接,您必须单击以识别 JSON 响应中的访问令牌。 | 各种参数 |
URL 参数 | 要包含在发送到指定网站的 HTTP 请求 URL 中的可选 URL 参数。 虽然也可以在以上 URL 参数中设置参数,但是在此处作为单独参数输入的 URL 参数将覆盖 URL 参数中提供的任何匹配参数。 在此参数中定义的 URL 参数将始终使用 URL 编码。 | 键值对 |
自定义标题 | 发送到指定网站的 HTTP 请求中将包含可选的自定义标题。 例如,自定义标题可用于指定第三方 API 密钥或身份验证标题。 | 键值对 |
其他日志记录 | 可以选择对原始 HTTP 请求和 Velocity 发出的请求启用日志记录。 注:仅当进行故障排除时,才应启用此参数,并且应在完成故障排除时禁用。 在启用参数后启动分析,调试级别日志即会出现在分析日志页面上。 如有必要,请联系 Esri 技术支持以获得故障排除方面的帮助。 | 布尔 |
注意事项和限制
下面是使用 HTTP 输出时的注意事项和限制:
- 在使用 OAuth 身份验证时:
- 在创建输出时,系统会向授权服务器和相关数据端点发送多次请求。 一些 API 对某些请求实施限速,这可能会影响输出创建。
- 出于安全原因,在编辑身份验证参数时,必须重新配置访问令牌请求 POST 正文。
- 必须可以通过 Internet 从外部访问 web 服务器。