JSON

Art der Daten

Benutzerdefinierter Datenfeed

Beschreibung

Ähnlich wie der 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 es sich bei den Daten immer um gültiges JSON handelt. Fusion verpackt das Ergebnis in ein Wrapper-JSON-Objekt, um Metadaten hinzuzufügen, bevor die Daten an Openmix gesendet werden. Die Openmix-App ist dafür verantwortlich, die Daten abzurufen und Entscheidungen für Fehlerbedingungen zu treffen.

Hinweis: Die JSON-Daten des Kunden in Kombination mit dem JSON-Wrapper müssen weniger als 10 KB groß sein, sonst lehnt Fusion sie ab. Dies ist eine harte Grenze, die von den Infrastruktur-App-Servern auferlegt wird.

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

Datenfeed-Format

Erfolgsbeispiel: Gültiges JSON abrufen

      {
        "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: Daten aus der Portal-API abrufen

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

Felder

• Text: Validierte JSON-Nutzlast, die von der Kunden-URL abgerufen wurde, oder leeres JSON-Objekt “{}”, wenn kein gültiges JSON abgerufen wurde
• Antwortcode: Gibt an, ob eine bestimmte HTTP-Anfrage erfolgreich abgeschlossen wurde.
• Status: “Erfolgreich”, wenn Fusion eine Antwort mit einem gültigen JSON im Hauptteil erhalten hat. Andernfalls eine Art von Fehler, z. B. “invalid_json”, “failure”, “timeout” usw.
• Timestamp: ISO 8601-Zeichenfolge, die die UTC-Zeit des Fusion-Aufrufs darstellt.

In Fusion einrichten

Sie können im linken Navigationsbereich unter Openmixauf Fusion Data Feeds zugreifen. Die ersten Schritte finden Sie in der Dokumentationzur Fusion Integration.

Wenn Sie zum dienstspezifischen Konfigurationsdialogfeld gelangen, geben Sie Folgendes ein:

• Name: Der Name, der dem Datenfeed gegeben wurde. Dies ist standardmäßig “Service — Plattformname”, wenn nicht angegeben.
• Run Every: Die Häufigkeit, mit der der Datenfeed vom Dienst aktualisiert wird.
• Plattform: Die Plattform, die mit dem Datenfeed verknüpft ist.
• URL: Die URL ist ein Endpunkt im Netzwerk des Kunden, der einige Daten zurückgibt, die der Kunde in Openmix sehen möchte. Der Antworttext wird von der URL abgerufen und unverändert an Openmix übertragen. Die einzige Anforderung ist, dass es 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 Sie den gewünschten Endpunkt (Zielendpunkt) des Kunden anrufen, besorgen Sie sich zunächst einen OAuth2-Anforderungstoken.
  • Der OAuth2-Token wird über den Token-Endpunkt des Kunden angefordert.

• In der OAuth2-Token-POST-Anforderung, die HTTPS sein muss, wird der folgende Anforderungstext an den Tokengenerator des Kunden übergeben:

  • client_id (Benutzereingabe)
  • client_secret (Benutzereingabe)
  • grant_type, fest codiert für 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 und der Anforderungsheader Authorization: Bearer {token} übergeben.

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

Sobald die Installation abgeschlossen ist, wird der Datenfeed auf der Startseite der Fusion-Datenfeeds mit einem grünen Status und Überwachungsmetriken im Protokollverlauf aufgeführt.

Um einen Fusion-Datenfeed zu bearbeiten, klicken Sie auf den Datenfeed in der Liste und dann auf die Schaltfläche Bearbeiten . Nachdem Sie die Konfiguration geändert haben, klicken Sie auf Speichern. Dadurch gelangen Sie zurück zur Datenfeed-Liste, in der Ihre Änderungen gespeichert und auf den Datenfeed angewendet werden.