3.1.4.1 デバイスを追加する

Milesight Development Platform にデバイスを追加し、現在のアプリケーションに関連付けます。

リクエスト URL

POST {base_url}/device/openapi/v1/devices

リクエストパラメータ

表 1. ヘッダーパラメータ
パラメータ 必須 タイプ 説明
Authorization Yes 文字列 API 呼び出しを行うための有効なアクセストークン。形式は Bearer {access_token} である必要があります。
表2. ボディパラメーター
パラメータ 必須 タイプ 説明
snDevEUI Yes 文字列 デバイスのSN(シリアル番号)またはEUI(拡張一意識別子)。
name Yes 文字列 このデバイスを識別するための名前を指定します。
description No 文字列 デバイスの説明を入力します。
project No 文字列 デバイスを識別および分類するためのタグを指定します。
tag No Array<String> デバイスを識別および分類するためのタグを指定します。1 つのデバイスには、最大 20 個のタグを追加できます。

応答パラメータ

 
パラメータ タイプ 説明
data Object<Device_Info> 追加されたデバイスの情報。
status 文字列  API リクエストの結果

  • Success
  • Failed
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 特定のデバイスを検索する
    現在のアプリケーションに関連付けられているすべてのデバイスから、特定のデバイスを検索します。

Milesight製品

ウェーブクレスト株式会社が運営するMilesight製品特設サイトです

居住者の健康を確保

お知らせ

  1. 2025-4-3

    ピープル・センシング 駆動型スマートビルディング

    People Sensing Insights を通じてビルインテリジェンスに革命をもたらします。…
  2. 2023-7-21

    LoRaWANの説明: 理論から実践へのガイド

    この包括的なビデオでは、LoRaWANを深く掘り下げ、その仕組み、利点、アプリケーションについて説明…
  3. 2023-4-6

    センシング・インサイト Milesight リブランディングのお知らせ

    https://youtu.be/r40DK40DjIY …
ページ上部へ戻る