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 数据馈送,请在列表中单击该数据馈送,然后单击编辑按钮。更改配置后,单击保存。这将使您返回到数据馈送列表,并将更改保存并应用于数据馈送。