JSON

Tipo de datos

Fuente de datos personalizada

Descripción

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

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

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

Formato de la fuente de datos

Ejemplo de éxito: Recuperación de 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: Recuperación de 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

• Body: Carga útil JSON validada recuperada de la URL del cliente o un objeto JSON vacío “{}” si no se recupera ningún JSON válido.
• Response Code: Indica si una solicitud HTTP específica se completó con éxito.
• Status: “Success” si Fusion recibió una respuesta con un JSON válido en el cuerpo. De lo contrario, algún tipo de fallo, por ejemplo, “invalid_json”, “failure”, “timeout”, etc.
• Timestamp: Cadena ISO 8601 que representa la hora UTC de la llamada de Fusion.

Configuración en Fusion

Puedes acceder a las fuentes de datos de Fusion desde el panel de navegación izquierdo, en Openmix. Para los pasos iniciales, consulta la documentación de integración de Fusion.

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

• Name: El nombre asignado a la fuente de datos. Por defecto, es “Service - Platform Name” si no se especifica.
• Run Every: La frecuencia con la que la fuente de datos se actualiza desde el servicio.
• Platform: La plataforma asociada a la fuente de datos.
• URL: La URL es un punto de conexión en la red del cliente que devuelve algunos datos que el cliente quiere 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 un JSON válido.

Configuración opcional de OAuth2

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

• Usa la siguiente implementación técnica:

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

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

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

La buena noticia para la implementación de JSON OAuth es que si estás llamando a un punto de conexión de API (Openmix o Radar), los campos de configuración de OAuth2 no son necesarios. Fusion ya conoce las credenciales de cliente de 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, la fuente de datos aparecerá en la página de inicio de las fuentes 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, haz clic en la fuente de datos de la lista y luego haz clic en el botón Modificar. Una vez que hayas cambiado la configuración, haz clic en Guardar. Esto te devolverá a la lista de fuentes de datos con tus cambios guardados y aplicados a la fuente de datos.