JSON

Datentyp

Benutzerdefinierter Daten-Feed

Beschreibung

Ähnlich dem HTTP Get Data Feed (mit optionaler OAuth2-Konfiguration) ruft der JSON-Feed Inhalte von einer vom Kunden bereitgestellten URL ab und stellt diese Daten einer Openmix-Anwendung zur Verfügung. Es wird davon ausgegangen, dass die Daten immer ein gültiges JSON sind. Fusion verpackt das Ergebnis in ein Wrapper-JSON-Objekt, um Metadaten hinzuzufügen, bevor die Daten an Openmix gesendet werden. Die Openmix-Anwendung ist für das Abrufen der Daten und das Treffen von Entscheidungen bei Fehlerbedingungen verantwortlich.

Hinweis: Die JSON-Daten des Kunden, kombiniert mit dem JSON-Wrapper, müssen kleiner als 10 KB sein, andernfalls wird Fusion sie ablehnen. Dies ist eine feste Grenze, die von den Infrastruktur-Anwendungsservern auferlegt wird.

Ähnlich dem HTTP Get Fusion-Daten-Feed bietet dieser Feed auch eine optionale OAuth2-Integration (die hauptsächlich zum Abrufen von Daten aus der Portal-API verwendet wird).

Daten-Feed-Format

Erfolgsbeispiel: Abrufen von gültigem 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-->

Erfolgsbeispiel: Abrufen von Daten aus der Portal-API

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

Felder

• Body: Validierte JSON-Nutzlast, die von der Kunden-URL abgerufen wird, oder leeres JSON-Objekt “{}” falls kein gültiges JSON abgerufen wurde
• Response Code: Zeigt an, ob eine bestimmte HTTP-Anfrage erfolgreich abgeschlossen wurde.
• Status: “Success”, wenn Fusion eine Antwort mit einem gültigen JSON im Body erhalten hat. Andernfalls eine Art von Fehler, z. B. “invalid_json”, “failure”, “timeout” und so weiter
• Timestamp: ISO 8601-Zeichenfolge, die die UTC-Zeit des Fusion-Aufrufs darstellt.

Einrichtung in Fusion

Sie können auf Fusion Data Feeds über den linken Navigationsbereich unter Openmix zugreifen. Für die ersten Schritte lesen Sie bitte die Fusion Integration Dokumentation.

Wenn Sie zum Dialogfeld für die dienstspezifische Konfiguration gelangen, geben Sie Folgendes ein:

• Name: Der Name, der dem Daten-Feed zugewiesen wird. Dieser wird standardmäßig auf “Service - Platform Name” gesetzt, wenn nicht anders angegeben.
• Run Every: Die Häufigkeit, mit der der Daten-Feed vom Dienst aktualisiert wird.
• Platform: Die Plattform, die mit dem Daten-Feed verknüpft ist.
• URL: Die URL ist ein Endpunkt im Netzwerk des Kunden, der Daten zurückgibt, die der Kunde in Openmix sehen möchte. Der Antwort-Body wird von der URL abgerufen und unverändert an Openmix weitergeleitet. Die einzige Anforderung ist, dass er gültiges JSON zurückgeben muss.

Optionale OAuth2-Konfiguration

Die optionale OAuth2-Konfiguration wurde ursprünglich entwickelt, um Openmix- und Radar-Daten über die ITM-API abzurufen.

• Verwenden Sie die folgende technische Implementierung:

  • Bevor der gewünschte (Ziel-)Endpunkt des Kunden aufgerufen wird, muss zuerst ein OAuth2-Anforderungstoken abgerufen werden
  • Das OAuth2-Token wird über den Token-Endpunkt des Kunden angefordert.

• In der OAuth2-Token-POST-Anfrage, die HTTPS sein muss, wird der folgende Anfragetext an den Token-Generator des Kunden übergeben:

  • client_id (Benutzereingabe)
  • client_secret (Benutzereingabe)
  • grant_type, fest codiert auf client_credentials
• Ein OAuth2-Token wird für nachfolgende API-Anfragen zurückgegeben.
• Mit einem gültigen OAuth2-Token wird die Ziel-URL des Kunden aufgerufen, wobei der Anforderungsheader Authorization: Bearer {token} übergeben wird

Die gute Nachricht für die JSON OAuth-Implementierung ist, dass, wenn Sie einen API-Endpunkt (Openmix oder Radar) aufrufen, die OAuth2-Konfigurationsfelder nicht erforderlich sind. Fusion kennt bereits die OAuth2-Client-Anmeldeinformationen des Benutzers und übergibt diese daher automatisch für alle ITM-basierten API-URLs.

Sobald die Installation abgeschlossen ist, wird der Daten-Feed auf der Startseite der Fusion-Daten-Feeds mit einem grünen Status und Überwachungsmetriken in der Protokollhistorie aufgeführt.

Um einen Fusion-Daten-Feed zu bearbeiten, klicken Sie in der Liste auf den Daten-Feed und dann auf die Schaltfläche Bearbeiten. Nachdem Sie die Konfiguration geändert haben, klicken Sie auf Speichern. Dies führt Sie zurück zur Daten-Feed-Liste, wobei Ihre Änderungen gespeichert und auf den Daten-Feed angewendet wurden.