Get HMS Information

GET

/openapi/v2.0/device/hms

Get Health Management System info; pass in device_sn_list to retrieve the abnormal status info for a list of devices.

⚠️ This API only returns alerts from the last 24 hours, with a maximum of 100 alert records per device.

Request

Query Params

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/openapi/v2.0/device/hms?device_sn_list=1581F6QAD238F0010244' \
--header 'X-User-Token: {{X-User-Token}}' \
--header 'X-Project-Uuid: be1e0ee4-2a3e-4150-82ca-ec1d2626efa3' \
--header 'X-Request-Id: {{$string.uuid}}' \
--header 'X-Request-Id: {{$string.uuid}}' \
--header 'X-Language: zh' \
--header 'X-Language: zh'

Responses

🟢200

application/json

Bodyapplication/json

Example

{
    "code": 0,
    "message": "OK",
    "data": {
        "list": [
            {
                "device_sn": "1581F6QAD238F0010244",
                "device_hms": {
                    "list": [
                        {
                            "level": "notification",
                            "module": "device_management",
                            "in_the_sky": "on_the_ground",
                            "imminent": false,
                            "code": "fpv_tip_0x16100084",
                            "message": "Weak Image Transmission Signal",
                            "args": {},
                            "hms_id": "hms_0x16100084_1719300000000",
                            "status": 2,
                            "status_key": "1581F6QAD238F0010244_fpv_tip_0x16100084",
                            "begin_time": 1719300000000,
                            "end_time": 1719300060000,
                            "device_data_create_time": 1719300000000,
                            "device_data_update_time": 1719300060000,
                            "domain_type": "drone",
                            "sub_hms_list": []
                        }
                    ]
                }
            }
        ]
    }
}

🟠400

🟠401

🟠403

🔴500

Modified at 2026-06-30 11:25:55

Make Device Enter Relay Pairing Mode

Acquire Control Permission