JSON

Tipo de datos

Fuente de datos personalizada

Descripción

Similar a HTTP Get Data Feed (con configuración opcional OAuth2), la fuente JSON extrae contenido de una URL suministrada por el cliente y pone estos datos a disposición de una aplicación Openmix. Se supone que los datos son siempre un JSON válido. Fusion envuelve el resultado en un objeto JSON contenedor para agregar metadatos antes de enviar los datos a Openmix. La aplicación Openmix es responsable de recuperar los datos y tomar cualquier decisión sobre las condiciones de error.

Nota: Los datos JSON del cliente combinados con el contenedor JSON deben tener un tamaño inferior a 10K o Fusion los rechazará. Este es un límite duro impuesto por los servidores de aplicaciones de infraestructura.

Similar a la fuente de datos HTTP Get Fusion, esta fuente también proporciona integración opcional OAuth2 (utilizada principalmente para recuperar datos de la API del portal).

Formato de fuente de datos

Ejemplo de éxito: Recuperando JSON válido

      {
        "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-->

Ejemplo de éxito: Recuperar datos de la API del portal

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

Campos

• Cuerpo: Carga JSON validada que se ha obtenido de la URL del cliente o el objeto JSON vacío “{}” si no se ha obtenido ningún JSON válido
• Código de respuesta: Indica si una solicitud HTTP específica se completó correctamente.
• Estado: “Success” si Fusion recibió una respuesta con un JSON válido en el cuerpo. De lo contrario, algún tipo de falla, por ejemplo, “invalid_json”, “error”, “tiempo de espera”, etc.
• Marca de tiempo: cadena ISO 8601 que representa la hora UTC de la llamada Fusion.

Configurar en Fusion

Puede acceder a Fusion Data Feeds desde el panel de navegación izquierdo, en Openmix. Para conocer los pasos iniciales, consulte la documentaciónde integración de Fusion.

Cuando llegue al cuadro de diálogo de configuración específica del servicio, introduzca lo siguiente:

• Nombre: El nombre asignado a la fuente de datos. Este valor predeterminado es “Servicio - Nombre de plataforma” si no se especifica.
• Ejecutar cada: La frecuencia con la que se actualiza la fuente de datos desde el servicio.
• Plataforma: La plataforma que está asociada al feed de datos.
• URL: La URL es un punto final en la red del cliente que devuelve algunos datos que el cliente desea ver en Openmix. El cuerpo de la respuesta se recupera de la URL y se envía tal cual a Openmix. El único requisito es que debe devolver JSON válido.

Configuración opcional de OAuth2

La configuración opcional de OAuth2 se diseñó originalmente para extraer datos de Openmix y Radar a través de la API ITM.

• Utilice la siguiente implementación técnica:

  • Antes de llamar al punto final deseado (destino) del cliente, primero obtenga un token de solicitud OAuth2
  • El token OAuth2 se solicita a través del punto final del token del cliente.

• En la solicitud POST token OAuth2, que debe ser HTTPS, el siguiente cuerpo de solicitud se pasa al generador de tokens del cliente:

  • client_id (entrada del usuario)
  • client_secret (entrada del usuario)
  • grant_type, codificado enclient_credentials
• Se devuelve un token OAuth2 para solicitudes API posteriores.
• Con un token OAuth2 válido, se llama a la URL de destino del cliente pasando el encabezado deAuthorization: Bearer {token} solicitud

La buena noticia para la implementación de JSON OAuth es que si está llamando a un punto final de API (Openmix o Radar), los campos de configuración OAuth2 no son necesarios. Fusion ya conoce las credenciales de cliente OAuth2 del usuario y, por lo tanto, las pasa automáticamente para todas las URL de API basadas en ITM.

Una vez completada la instalación, el feed de datos aparecerá en la página de inicio de los feeds de datos de Fusion con un estado verde y métricas de supervisión en el historial de registros.

Para modificar una fuente de datos de Fusion, haga clic en la fuente de datos de la lista y, a continuación, haga clic en el botón Modificar. Una vez que haya cambiado la configuración, haga clic en Guardar. De este modo, volverá a la lista de fuentes de datos con los cambios guardados y aplicados a la fuente de datos.