JSON

数据类型

自定义数据馈送

说明

与 HTTP 获取数据源(使用可选的 OAuth2 配置)类似,JSON 源从客户提供的 URL 中提取内容,并将这些数据提供给 Openmix 应用程序。假定数据始终是有效的 JSON。在将数据发送到 Openmix 之前,Fusion 将结果包装在包装器 JSON 对象中以添加元数据。Openmix 应用负责检索数据并针对错误情况做出任何决定。

注意:客户的JSON数据与JSON包装器相结合的大小必须小于1万个,否则Fusion会拒绝。这是基础结构应用程序服务器施加的硬限制。

与 HTTP Get Fusion 数据源类似,该订阅源还提供可选的 OAuth2 集成(主要用于从门户 API 检索数据)。

数据馈送格式

成功示例:检索有效的 JSON

      {
        "body": {
          "active_user_sessions": 9,
          "available": "YES",
          "component": "fusion",
          "current_time": "2017-05-31 17:16:19"
        },
          "responseCode": 200,
          "status": "success",
          "timestamp": "2017-05-31T17:16:19.655Z"
      }
<!--NeedCopy-->

成功示例:从门户 API 检索数据

{"body":[["Akamai CDN,"856244],["Telenor CDN,"1575138],["Arkena North,"1567285]],"timestamp":"2017-04-18T19:21:20.490Z","responseCode":200,"status":"success"}

字段

  • 正文: 从客户 URL 检索经过验证的 JSON 负载;如果未检索到有效的 JSON,则为空 JSON 对象“{}”
  • 响应代码: 表示特定的 HTTP 请求是否成功完成。
  • 状态: 如果 Fusion 收到的响应正文中有效 JSON,则状态为“成功”。否则,会出现某种类型的故障,例如“invalid_json”、“failure”、“timeout”等
  • 时间戳: 表示 Fusion 通话的 UTC 时间的 ISO 8601 字符串。

在Fusion中设置

您可以从左侧的导航窗格访问“Fusion 数据馈送”,它位于 Openmix 下。有关初始步骤,请参阅 Fusion 集成文档

当您进入服务特定的配置对话框时,输入以下内容:

  • 名称:为数据馈送指定的名称。如果未指定,则默认为“服务 - 平台名称”。
  • 运行频率:从服务更新数据馈送的频率。
  • 平台:与数据馈送关联的平台。
  • URL: 此 URL 是客户网络上的一个端点,它返回客户希望在 Openmix 中看到的一些数据。从 URL 中检索响应正文并按原样推送到 Openmix。唯一的要求是它必须返回有效的 JSON。

可选的 OAuth2 配置

可选的 OAuth2 配置最初旨在通过 ITM API 提取 Openmix 和 Radar 数据。

  • 请使用以下技术实现:

    • 在调用客户所需的(目标)端点之前,首先获取 OAuth2 请求令牌
    • OAuth2 令牌是通过客户的令牌端点请求的。
  • 在必须为 HTTPS 的 OAuth2 令牌 POST 请求中,以下请求正文会传递给客户的令牌生成器:

    • client_id(用户输入)
    • client_secret(用户输入)
    • grant_type,硬编码为 client_credentials
  • 对于后续的 API 请求,将返回 OAuth2 令牌。
  • 使用有效的 OAuth2 令牌,客户的目标 URL 称为传入 Authorization: Bearer {token} 请求标头

对于 JSON OAuth 实现来说,好消息是,如果您调用 API 端点(Openmix 或 Radar),则不需要 OAuth2 配置字段。Fusion 已经知道用户的 OAuth2 客户端凭据,因此会自动将它们传递给所有基于 ITM 的 API URL。

安装完成后,数据源将列在 Fusion 数据源主页上,日志历史记录中显示绿色状态和监视指标。

要编辑某个 Fusion 数据馈送,请在列表中单击该数据馈送,然后单击编辑按钮。更改配置后,单击保存。这将使您返回到数据馈送列表,并将更改保存并应用于数据馈送。

JSON