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の概要システムをサードパーティのアプリケーションと統合するためのアプリケーションプログラミングインターフェース (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.2 特定のデバイスを検索する現在のアプリケーションに関連付けられているすべてのデバイスから、特定のデバイスを検索します。