JSON

Type de données

Flux de données personnalisé

Description

Tout comme le flux de données HTTP Get (avec configuration OAuth2 facultative), le flux JSON extrait le contenu d’une URL fournie par le client et met ces données à la disposition d’une application Openmix. Les données sont supposées être toujours dans un format JSON valide. Fusion encapsule le résultat dans un objet JSON wrapper pour ajouter des métadonnées avant d’envoyer les données à Openmix. L’application Openmix est chargée de récupérer les données et de prendre toute décision concernant les conditions d’erreur.

Remarque : les données JSON du client combinées au wrapper JSON doivent être d’une taille inférieure à 10 K, faute de quoi Fusion les rejettera. Il s’agit d’une limite stricte imposée par les serveurs d’applications de l’infrastructure.

Tout comme le flux de données HTTP Get Fusion, ce flux fournit également une intégration facultative d’OAuth2 (principalement utilisée pour récupérer des données depuis l’API du portail).

Format de flux de données

Exemple de réussite : récupération d’un JSON valide

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

Exemple de réussite : récupération de données depuis l’API du portail

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

Champs

• Corps : Charge utile JSON validée extraite de l’URL du client ou de l’objet JSON vide « {} » si aucun JSON valide n’est récupéré
• Code de réponse : indique si une requête HTTP spécifique a été exécutée avec succès.
• État : « Succès » si Fusion a reçu une réponse contenant un JSON valide dans le corps. Sinon, un certain type d’échec, par exemple « invalid_json », « échec », « timeout », etc.
• Horodatage : chaîne ISO 8601 représentant l’heure UTC de l’appel Fusion.

Configuration dans Fusion

Vous pouvez accéder aux flux de données Fusion depuis le volet de navigation de gauche, sous Openmix. Pour les étapes initiales, reportez-vous à la documentationd’intégration de Fusion.

Lorsque vous accédez à la boîte de dialogue de configuration spécifique au service, entrez les informations suivantes :

• Nom : nom donné au flux de données. La valeur par défaut est « Service - Nom de la plate-forme » si ce dernier n’est pas spécifié.
• Exécuter chaque fois : fréquence à laquelle le flux de données est mis à jour à partir du service.
• Plateforme : plateforme associée au flux de données.
• URL : L’URL est un point de terminaison du réseau du client qui renvoie certaines données que le client souhaite voir dans Openmix. Le corps de la réponse est extrait de l’URL et envoyé tel quel vers Openmix. La seule exigence est qu’il doit renvoyer un JSON valide.

Configuration d’OAuth2 facultative

La configuration facultative d’OAuth2 a été initialement conçue pour extraire les données Openmix et Radar via l’API ITM.

• Utilisez la mise en œuvre technique suivante :

  • Avant d’appeler le point de terminaison (cible) souhaité par le client, procurez-vous d’abord un jeton de requête OAuth2
  • Le jeton OAuth2 est demandé via le point de terminaison du jeton du client.

• Dans la requête POST du jeton OAuth2 qui doit être HTTPS, le corps de requête suivant est transmis au générateur de jetons du client :

  • client_id (saisie utilisateur)
  • client_secret (saisie utilisateur)
  • grant_type, codé en dur pour client_credentials
• Un jeton OAuth2 est renvoyé pour les requêtes d’API suivantes.
• Avec un jeton OAuth2 valide, l’URL cible du client est appelée en passant dans l’en-tête de requête Authorization: Bearer {token}

La bonne nouvelle pour la mise en œuvre JSON OAuth est que si vous appelez un point de terminaison d’API (Openmix ou radar), les champs de configuration OAuth2 ne sont pas obligatoires. Fusion connaît déjà les informations d’identification du client OAuth2 de l’utilisateur et les transmet donc automatiquement pour toutes les URL d’API basées sur ITM.

Une fois l’installation terminée, le flux de données sera répertorié sur la page d’accueil des flux de données Fusion avec un statut vert et des mesures de surveillance dans l’historique des journaux.

Pour modifier un flux de données Fusion, cliquez sur le flux de données dans la liste, puis sur le bouton Modifier . Une fois que vous avez modifié la configuration, cliquez sur Enregistrer. Cela vous ramène à la liste des flux de données avec vos modifications enregistrées et appliquées au flux de données.