JSON

データの種類

カスタムデータフィード

説明

HTTP Get データフィード (オプションの OAuth2 設定) と同様に、JSON フィードは顧客提供の URL からコンテンツをプルし、Openmix アプリケーションでこのデータを使用できるようにします。データは、常に有効な JSON であると見なされます。Fusion は、データを Openmix に送信する前に、結果をラッパー JSON オブジェクトにラップし、メタデータを追加します。Openmix アプリは、データの取得とエラー条件の決定を行います。

: JSON ラッパーと組み合わせた顧客の JSON データのサイズは 10 K 未満である必要があります。そうしないと、Fusion はそれを拒否します。これは、インフラストラクチャアプリサーバーによって課されるハードリミットです。

HTTP Get Fusion データフィードと同様に、このフィードはオプションの OAuth2 統合を提供します (主にポータル API からデータを取得するために使用されます)。

データフィード形式

成功例:有効な 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-->

成功例:ポータル API からのデータの取得

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

フィールド

  • 本文: 検証された JSON ペイロード顧客 URL から取得されるか、有効な JSON が取得されなかった場合は空の JSON オブジェクト「{}」
  • レスポンスコード: 特定の HTTP 要求が正常に完了したかどうかを示します。
  • ステータス: Fusion が本文に有効な JSON を含む応答を受信した場合は「成功」。それ以外の場合は、「invalid_json」、「失敗」、「タイムアウト」など、何らかの種類の失敗
  • タイムスタンプ: Fusion呼び出しの UTC 時刻を表す ISO 8601 文字列。

Fusionでセットアップする

Fusion データフィードには、左側のナビゲーションウィンドウの Openmixの下からアクセスできます。最初の手順については、Fusion インテグレーションのドキュメントを参照してください。

サービス固有の構成ダイアログボックスが表示されたら 、以下を入力します:

  • 名前: データフィードに与えられた名前。指定しない場合、デフォルトは「サービス-プラットフォーム名」になります。
  • Run Every: サービスからデータフィードが更新される頻度。
  • プラットフォーム: データフィードに関連付けられているプラットフォーム。
  • URL: URL は、顧客が Openmix で見たいデータを返す、お客様のネットワーク上のエンドポイントです。レスポンス本文は URL から取得され、そのままOpenmixにプッシュされます。唯一の要件は、有効な JSON を返す必要があることです。

オプションの OAuth2 設定

オプションのOAuth2構成は、もともとITM APIを介してOpenmixとRadarのデータを取得するように設計されていました。

  • 次の技術的な実装を使用します:

    • お客様の希望の(ターゲット)エンドポイントを呼び出す前に、まず OAuth2 リクエストトークンを取得します
    • OAuth2 トークンは、顧客のトークンエンドポイントを介して要求されます。
  • HTTPS である必要がある OAuth2 トークン POST 要求では、次のリクエスト本文が顧客のトークンジェネレータに渡されます。

    • client_id (ユーザ入力)
    • client_secret (ユーザ入力)
    • grant_typeclient_credentialsにハードコードされている
  • 後続の API リクエストでは、OAuth2 トークンが返されます。
  • 有効なOAuth2トークンを使用すると、Authorization: Bearer {token}リクエストヘッダーを渡すことで顧客のターゲット URL が呼び出されます

JSON OAuth 実装の朗報は、API エンドポイント (Openmix またはレーダー) を呼び出す場合、OAuth2 設定フィールドは必要ないということです。Fusion はすでにユーザーの OAuth2 クライアント認証情報を認識しているため、すべての ITM ベースの API URL に対して自動的に渡されます。

インストールが完了すると、Fusion データフィードのホームページにデータフィードが表示され、ログ履歴に緑色のステータスとモニタリングメトリックが表示されます。

Fusion データフィードを編集するには、一覧のデータフィードをクリックし、[ 編集 ] ボタンをクリックします。設定を変更したら、[ 保存] をクリックします。これにより、変更を保存してデータフィードに適用したデータフィードリストに戻ります。

JSON