このトピックでは、サードパーティのアプリケーションが、デバイスが Milesight Development Platform にデータを報告したときにリアルタイムの通知を受け取ることができるように、Webhook イベント通知を設定する方法について説明します。
制限
こちらをクリックして、各プランでサポートされる Webhook イベントの最大数をご確認ください。
前提条件
- Milesight Development Platform でアプリケーションを作成し、このアプリケーションを有効にしていること。
- サードパーティのアプリケーションから、公開されている Webhook URL を取得していること。
手順
- Milesight Development Platform にログインします。
- Application に移動し、目的のアプリケーションをクリックします。
注: 選択したアプリケーションが、アクセストークンを取得するために使用したアプリケーションと一致していることを確認してください。 - Application Settings セクションで、以下を設定します。
- Webhook スイッチをオンにします。
- Callback URI セクションで、Add をクリックします
- イベント通知を受信するための Webhook コールバック URI を入力します。
-
- Test をクリックして、Webhook が正常に動作しているかどうかを確認します。テスト通知 が入力したすべての Webhook コールバック URI に送信されます。
- Save をクリックします。
結果
Webhook イベント通知の設定が完了しました。デバイスが Milesight Development Platform にデータを報告すると、HTTP コールバックがトリガーされ、報告されたデータがコールバック URI にプッシュされます。Webhook シミュレーション を参照して、Webhook 通知をシミュレーションすることができます。
関連記事
ソリューション / IoT サポート
- ▢3. Milesight開発プラットフォームAPIの概要システムをサードパーティのアプリケーションと統合するためのアプリケーションプログラミングインターフェース (API) を提供しています
- 3.1.1.1 APIリクエスト構造Milesight Development Platform APIのリクエスト構造について説明します
- 3.1.1.2 API レスポンス結果APIリクエストを受信すると、Milesight Development Platformはリクエストの結果を示すHTTPステータスコードと、API呼び出しで要求された情報を含むJSONレスポンスボディを返します。
- 3.1.2 API インターフェース一覧このトピックでは、Milesight Development Platform API のインターフェースの要約リストを提供します。
- 3.1.3.1 API 認証ルールMilesight Development Platform APIは、OAuth 2.0を使用して認証を行い、アプリケーションがMilesight Development Platform上のリソースにアクセスするためのセキュアなトークンを発行します。
- 3.1.3.2 API アクセス トークンの取得アクセス トークンは、認証された API 呼び出しを検証するために使用されます。アプリケーションはまずアクセス トークンをリクエストし、その後、Milesight Development Platform API にアクセスするすべてのリクエストにそのトークンを含める必要があります。
- 3.1.3.3 API アクセス トークンの更新Milesight Development Platformとアプリケーション間の安全でスムーズな通信を確保するため、アクセス トークンが有効期限切れになる前に更新する必要があります。
- 3.1.4.1 デバイスを追加するMilesight Development Platform にデバイスを追加し、現在のアプリケーションに関連付けます。
- 3.1.4.10 特定のデバイスの設定を取得する特定のデバイスの詳細な設定を照会します。
- 3.1.4.2 特定のデバイスを検索する現在のアプリケーションに関連付けられているすべてのデバイスから、特定のデバイスを検索します。
- 3.1.4.3 特定のデバイスをクエリする特定のデバイスの詳細情報を照会します。
- 3.1.4.4 デバイスのTSLモデルを照会するデバイスの TSL (Thing Specification Language) モデルをクエリします。
- 3.1.4.5 デバイス サービスを非同期に呼び出すデバイスのサービスを非同期で呼び出します。
- 3.1.4.5 プロパティ レポートの履歴データを照会するデバイスプロパティレポートの履歴データを照会するためのインターフェースについて紹介します。
- 3.1.4.6 デバイス情報の更新デバイスの名前、説明、およびタグを更新します。
- 3.1.4.7 デバイス プロパティを段階的に更新するデバイスのプロパティを段階的に更新します。これは、単一のデバイスおよび単純なパラメータの更新に適しています。
- 3.1.4.8 デバイスを削除するMilesight Development Platform からデバイスを削除します。
- 3.1.4.9 アプリケーションからデバイスを削除するMilesight Development Platform のアプリケーションからデバイスを削除します。
- 3.1.5.1 RPS用のプロファイルURLを指定するデバイスの RPS (リダイレクトおよびプロビジョニングサービス) でプロファイル URL を指定します。
- 3.1.5.2 クエリ プロファイル URL リスト現在のアプリケーション内のプロファイル URL リストを照会します。
- 3.1.5.3 デバイスのRPSレコードの削除RPS のプロファイル URL を指定してデバイスを Milesight Development Platform に追加する場合、またはデバイスを別のプラットフォームに転送する場合は、RPS レコードの一意性を確保するために、デバイスの現在の RPS レコードを削除する必要があります。
- 3.1.6.1 構成タスクの作成リモートデバイスに設定を適用するための設定タスクを作成します。これは、大量のデバイスや設定パラメータが多い場合に適しています。単一のデバイスや単純なパラメータの更新については、「デバイスプロパティの段階的な更新」を参照してください。
- 3.2.1 イベント通知の概要要件、Webhook ワークフロー、サポートされている Webhook イベントなど、Milesight Development Platform Webhook の概要について詳しく説明します。
- 3.2.2 Webhook イベント通知の設定サードパーティのアプリケーションが、デバイスが Milesight Development Platform にデータを報告したときにリアルタイムの通知を受け取ることができるように、Webhook イベント通知を設定する方法について説明します。
- 3.2.3.1 デバイスデータイベント「DEVICE_DATA」の例と説明について説明します。
- 3.2.3.2 タスクデータイベント「TASK_DATA」の例と詳細について説明します。