目次
1. はじめに
2. ユーザーガイド
- ▢2.1 アカウントとデータセンター
- ▢2.2 ダッシュボードの概要
- ▢2.3 アプリケーション概要
- ▢2.4 デバイスの概要
- 2.4.1 デバイスの追加
- 2.4.2 デバイスの管理
- 2.4.3 デバイスの設定
- 2.4.4 デバイスのアップグレード
- 2.4.5 デバイスの共有
- 2.4.6 リモートアクセスデバイス
- 2.4.7 デバイスリストの列をカスタマイズする
- ▢2.5 リソース概要
- ▢2.6 タスク センター 概要
- ▢2.7 RPSの概要
3. APIレファレンス
- ▢3. Milesight開発プラットフォームAPIの概要
- 3.1.1 APIリクエスト
- 3.1.2 API インターフェース一覧
- 3.1.3 API 認証
- 3.1.4 デバイス管理
- 3.1.5 RPS管理
- 3.1.6 タスク管理
- 3.2 Webhookイベント通知
4. デバイスレファレンス
5. よくある質問
Milesight Development Platform にデバイスを追加し、現在のアプリケーションに関連付けます。
リクエスト URL
POST {base_url}/device/openapi/v1/devices
リクエストパラメータ
パラメータ | 必須 | タイプ | 説明 |
---|---|---|---|
Authorization | Yes | 文字列 | API 呼び出しを行うための有効なアクセストークン。形式は Bearer {access_token} である必要があります。 |
パラメータ | 必須 | タイプ | 説明 |
---|---|---|---|
snDevEUI | Yes | 文字列 | デバイスのSN(シリアル番号)またはEUI(拡張一意識別子)。 |
name | Yes | 文字列 | このデバイスを識別するための名前を指定します。 |
description | No | 文字列 | デバイスの説明を入力します。 |
project | No | 文字列 | デバイスを識別および分類するためのタグを指定します。 |
tag | No | Array<String> | デバイスを識別および分類するためのタグを指定します。1 つのデバイスには、最大 20 個のタグを追加できます。 |
応答パラメータ
パラメータ | タイプ | 説明 |
---|---|---|
data | Object<Device_Info> | 追加されたデバイスの情報。 |
status | 文字列 | API リクエストの結果
|
requestId | 文字列 | The unique ID of the request, which can be used to quickly locate the request. |
- Device_Info
-
- パラメータ
- タイプ
- 説明
sn 文字列 - このデバイスの SN (シリアル番号)
deviceId Long - Milesight 開発プラットフォームにおけるこのデバイスの一意の ID。
注:この deviceID は、API によるデバイスの管理や設定に必要なため、将来の使用のために保存しておくことをお勧めします。
devEUI 文字列 - 注: 製品モデルによっては、このパラメータは返されない場合があります。
このデバイスの EUI (Extended Unique Identifier)。
imei 文字列 - 注: 製品モデルによっては、このパラメータは返されない場合があります。
このデバイスの IMEI (International Mobile Equipment Identity)。
例
- リクエスト例
- VS121-P を Milesight 開発プラットフォームに追加し、このアプリケーションに関連付けます。
-
POST /device/openapi/v1/devices HTTP/1.1 Host: demo.milesight.com Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6InllYXN0b25lLWRlZmF1bHQta2V5LWlkIn0.eyJncmFudF90eXBlIjoiY2xpZW50X2NyZWRlbnRpYWxzIiwic2NvcGUiOlsib3BlbmFwaSJdLCJjbGllbnRfZXh0Ijp7ImFwcF9pZCI6IjE3MzY5NTQ4MDE3MTMzMjgxMzAifSwiZXhwIjoxNzAzMjEzMDk4LCJhdXRob3JpdGllcyI6WyJST0xFX0NMSUVOVCJdLCJqdGkiOiJiYjJjN2U4Yy03NGQwLTQ4NjEtODE3MS1iYTc0NWRlMGY0NmQiLCJjbGllbnRfaWQiOiI4OTNkNzdjNy1mMGNiLTRmMzQtOWNhMS03YzJhNGNmMTEzNDgiLCJ0cyI6MTcwMzIwOTQ5ODMzNH0 Content-Type: application/json { "snDevEUI": "66003649xxxx", "name": "Sample VS121-P", "description": "VS121-P on meeting room 3D", "project": "Workplace-management" }
- 応答例
-
HTTP/1.1 200 OK { "data": { "sn": "66003649xxxx", "deviceId": "1737007595605147649" }, "status": "Success", "requestId": "22bd34b548bca2981b4bb5f222523caf" }
関連記事
ソリューション / IoT サポート
- ▢3. Milesight開発プラットフォームAPIの概要 2025年6月21日システムをサードパーティのアプリケーションと統合するためのアプリケーションプログラミングインターフェース (API) を提供しています
- 3.1.1.1 APIリクエスト構造 2025年6月21日Milesight Development Platform APIのリクエスト構造について説明します
- 3.1.1.2 API レスポンス結果 2025年6月21日APIリクエストを受信すると、Milesight Development Platformはリクエストの結果を示すHTTPステータスコードと、API呼び出しで要求された情報を含むJSONレスポンスボディを返します。
- 3.1.2 API インターフェース一覧 2025年6月21日このトピックでは、Milesight Development Platform API のインターフェースの要約リストを提供します。
- 3.1.3.1 API 認証ルール 2025年6月21日Milesight Development Platform APIは、OAuth 2.0を使用して認証を行い、アプリケーションがMilesight Development Platform上のリソースにアクセスするためのセキュアなトークンを発行します。
- 3.1.3.2 API アクセス トークンの取得 2025年6月21日アクセス トークンは、認証された API 呼び出しを検証するために使用されます。アプリケーションはまずアクセス トークンをリクエストし、その後、Milesight Development Platform API にアクセスするすべてのリクエストにそのトークンを含める必要があります。
- 3.1.3.3 API アクセス トークンの更新 2025年6月21日Milesight Development Platformとアプリケーション間の安全でスムーズな通信を確保するため、アクセス トークンが有効期限切れになる前に更新する必要があります。
- 3.1.4.1 デバイスを追加する 2025年6月21日Milesight Development Platform にデバイスを追加し、現在のアプリケーションに関連付けます。
- 3.1.4.2 特定のデバイスを検索する 2025年6月21日現在のアプリケーションに関連付けられているすべてのデバイスから、特定のデバイスを検索します。
- 3.1.4.3 特定のデバイスをクエリする 2025年6月21日特定のデバイスの詳細情報を照会します。
- 3.1.4.4 デバイスのTSLモデルを照会する 2025年6月21日デバイスの TSL (Thing Specification Language) モデルをクエリします。
- 3.1.4.5 プロパティ レポートの履歴データを照会する 2025年6月21日デバイスプロパティレポートの履歴データを照会するためのインターフェースについて紹介します。
- 3.1.4.6 デバイス サービスを非同期に呼び出す 2025年6月21日デバイスのサービスを非同期で呼び出します。
- 3.1.4.7 デバイス情報の更新 2025年6月21日デバイスの名前、説明、およびタグを更新します。
- 3.1.4.8 デバイス プロパティを段階的に更新する 2025年6月21日デバイスのプロパティを段階的に更新します。これは、単一のデバイスおよび単純なパラメータの更新に適しています。
- 3.1.4.9 デバイスを削除する 2025年6月21日Milesight Development Platform からデバイスを削除します。
- 3.1.4.X アプリケーションからデバイスを削除する 2025年6月21日Milesight Development Platform のアプリケーションからデバイスを削除します。
- 3.1.4.XI 特定のデバイスの設定を取得する 2025年6月21日特定のデバイスの詳細な設定を照会します。
- 3.1.5.1 RPS用のプロファイルURLを指定する 2025年6月21日デバイスの RPS (リダイレクトおよびプロビジョニングサービス) でプロファイル URL を指定します。
- 3.1.5.2 クエリ プロファイル URL リスト 2025年6月21日現在のアプリケーション内のプロファイル URL リストを照会します。
- 3.1.5.3 デバイスのRPSレコードの削除 2025年6月21日RPS のプロファイル URL を指定してデバイスを Milesight Development Platform に追加する場合、またはデバイスを別のプラットフォームに転送する場合は、RPS レコードの一意性を確保するために、デバイスの現在の RPS レコードを削除する必要があります。
- 3.1.6.1 構成タスクの作成 2025年6月21日リモートデバイスに設定を適用するための設定タスクを作成します。これは、大量のデバイスや設定パラメータが多い場合に適しています。単一のデバイスや単純なパラメータの更新については、「デバイスプロパティの段階的な更新」を参照してください。
- 3.2.1 イベント通知の概要 2025年6月21日要件、Webhook ワークフロー、サポートされている Webhook イベントなど、Milesight Development Platform Webhook の概要について詳しく説明します。
- 3.2.2 Webhook イベント通知の設定 2025年6月21日サードパーティのアプリケーションが、デバイスが Milesight Development Platform にデータを報告したときにリアルタイムの通知を受け取ることができるように、Webhook イベント通知を設定する方法について説明します。
- 3.2.3.1 デバイスデータ 2025年6月21日イベント「DEVICE_DATA」の例と説明について説明します。
- 3.2.3.2 タスクデータ 2025年6月21日イベント「TASK_DATA」の例と詳細について説明します。
- 3.2.3.3 Webhook テスト 2025年6月21日イベント「WEBHOOK_TEST」の例と解説について説明します。
- 3.2.3.4 システムメッセージ 2025年6月21日イベント「SYSTEM_MESSAGES」の例と説明を提供します。