3.1.4.3 特定のデバイスをクエリする

特定のデバイスの詳細情報を照会します。

リクエスト URL

GET {base_url}/device/openapi/v1/devices/{deviceId}

リクエストパラメータ

表 1. ヘッダーパラメータ
パラメータ 必須 タイプ 説明
Authorization Yes String API 呼び出しを行うための有効なアクセストークン。

形式は Bearer {access_token} である必要があります。
表 2. パスパラメータ
パラメータ 必須 タイプ 説明
deviceId Yes Long このデバイスの一意の ID。デバイスを追加するときに返されます。

注： deviceID を保存していない場合は、特定のデバイスを検索を使用してデバイスの ID を照会できます。

応答パラメータ

 
パラメータ タイプ 説明
data Object<Device_Info> 照会したデバイスの詳細情報。
status String  API リクエストの結果。

  • Success
  • Failed
requestId String リクエストの一意の ID。リクエストをすばやく見つけるために使用できます。
Device_Info
 
パラメータ タイプ 説明
sn String
このデバイスの SN (シリアル番号)。
imei String
このデバイスの IMEI (国際移動体装置識別番号)
rpsStatus String
デバイスの RPS サービスのステータス。
  • ACTIVATE: このデバイスのRPSが有効です。
  • UNACTIVATED: このデバイスのRPSが無効または未対応です。
name String
デバイスの名前
model String
デバイスのモデル
hardwareVersion String
デバイスのハードウェアバージョン
firmwareVersion String
デバイスのファームウェアバージョン
electricity Integer
デバイスのバッテリーレベル
lastUpdateTime Long
デバイスの最新のレポートのタイムスタンプ
application Object
デバイスに関連付けられたアプリケーションの情報
applicationId Long
このアプリケーションのユニークID
applicationName String
このアプリケーションの名前
project String
デバイスのプロジェクトタグ
description String
デバイスの説明
deviceId Long
このデバイスのユニークID
devEUI String
このデバイスのEUI（拡張一意識別子）
connectStatus String
デバイスの接続状態
  • ONLINE: デバイスは Milesight 開発プラットフォームにアクティブに接続されています。
  • OFFLINE: デバイスは現在 Milesight 開発プラットフォームに接続されていません。
  • DISCONNECT: デバイスは Milesight 開発プラットフォームから切断されています。
licenseStatus String
デバイスのライセンスステータス
  • VALID: デバイスは使用できます
  • INVALID: プロプランの有効期限が切れたため、デバイスは使用できなくなりました。
deviceType String このデバイスのタイプ。

  • GATEWAY: サブデバイスと Milesight 開発プラットフォーム間の通信を設定するゲートウェイデバイス。
  • SUB_DEVICE: Milesight 開発プラットフォームに接続するためにゲートウェイを必要とする、インターネットにアクセスできないデバイス。
  • COMMON: Milesight 開発プラットフォームに直接接続できる、インターネットにアクセスできるデバイス。
tag Array<String> このデバイスのタグ。

例

リクエスト例
ID「1739930666380779522」のデバイスの詳細情報を照会します。
GET /device/openapi/v1/devices/1739930666380779522 HTTP/1.1
Host: demo.milesight.com
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6InllYXN0b25lLWRlZmF1bHQta2V5LWlkIn0.eyJncmFudF90eXBlIjoiY2xpZW50X2NyZWRlbnRpYWxzIiwic2NvcGUiOlsib3BlbmFwaSJdLCJjbGllbnRfZXh0Ijp7ImFwcF9pZCI6IjE3MzY5NTQ4MDE3MTMzMjgxMzAifSwiZXhwIjoxNzAzMjEzMDk4LCJhdXRob3JpdGllcyI6WyJST0xFX0NMSUVOVCJdLCJqdGkiOiJiYjJjN2U4Yy03NGQwLTQ4NjEtODE3MS1iYTc0NWRlMGY0NmQiLCJjbGllbnRfaWQiOiI4OTNkNzdjNy1mMGNiLTRmMzQtOWNhMS03YzJhNGNmMTEzNDgiLCJ0cyI6MTcwMzIwOTQ5ODMzNH0
Content-Type: application/json
レスポンス例
HTTP/1.1 200 OK
{
    "data": {
        "sn": "6791D1970467xxxx",
        "rpsStatus": "UNACTIVATED",
        "name": "Demo Device",
        "model": "WS203",
        "hardwareVersion": "v1.0",
        "firmwareVersion": "v1.1",
        "electricity": 97,
        "lastUpdateTime": 1704172785337,
        "application": {
            "applicationId": "1734475086466600962",
            "applicationName": "Demo"
        },
        "project": "Demo",
        "description": "Demo",
        "licenseStatus": "VALID",
        "deviceType": "SUB-DEVICE",
        "tag": [],
        "deviceId": "1739930666380779522",
        "devEUI": "24E124791D1xxxx",
        "connectStatus": "ONLINE"
    },
    "status": "Success",
    "requestId": "c15d037ea4c74565ecced1725c8d46d6"
}

関連記事

トップページに戻る

ソリューション / IoT サポート


Milesight製品

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

居住者の健康を確保

  1. COVID-19の脅威にさらされた買い物客と労働者のためのスーパーマーケットアンビエンスモニタリング
  2. IoTでオフィスをグレードアップ。エネルギッシュなオフィス環境モニタリング

お知らせ

  1. 2025-4-3

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

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

  2. 2023-7-21

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

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

  3. 2023-4-6

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

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