Batch Get Project Device HMS Events - FlightHub 2 OpenAPI V2.0 (On-Premises)

On "Project Device Topology/Team Page", retrieve HMS events of a group of devices in project within last 24 hours in one call, along with each device's "Read Timestamp". Frontend uses this API to add alert badges to device list in project — devices with most recent events device_data_update_time > read_time are treated as new events requiring red dot reminders. Difference from "Get Organization Device HMS Event List" API: scope is project (not organization); does not paginate; query window is server-fixed to last 24 hours; level is fixed to [1,2] (Caution+Warning); does not support time window, level, module, and other filters; returns grouped by device (each SN has one group of events + one read_time). These non-configurable constraints align with "Project Page Badge" business positioning — only displays near-term events users need to attention. Authentication: caller must be project member; API validates each SN in project; single SN not in project is silently removed from response (does not raise overall error; caller should verify response contains SN against input SN).

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200

application/json

Bodyapplication/json

Example

{
    "code": 0,
    "message": "OK",
    "data": {
        "list": [
            {
                "device_sn": "2TUDK87654321",
                "device_hms": {
                    "read_time": 1717530000000,
                    "list": [
                        {
                            "id": "evt-9b3a0f44",
                            "bid": "bid-7e5e",
                            "tid": "tid-aaaa",
                            "device_sn": "2TUDK87654321",
                            "level": 2,
                            "module": 3,
                            "message": "Dock battery temperature is too high, charging has been suspended",
                            "status": 1,
                            "code": "dock_battery_temp_high",
                            "device_data_create_time": 1717530100000,
                            "device_data_update_time": 1717531000000,
                            "args": {
                                "battery_index": 1,
                                "temperature": 65
                            },
                            "device_type": "dock",
                            "domain_type": "airport",
                            "imminent": 0,
                            "in_the_sky": 0,
                            "joint_key": "dock.battery.temp_high",
                            "sub_hms_list": [],
                            "status_key": "dock.battery.temp_high.65"
                        }
                    ]
                }
            },
            {
                "device_sn": "3ABDQ12345678",
                "device_hms": {
                    "read_time": 1717529900000,
                    "list": [
                        {
                            "id": "evt-31a8c0b1",
                            "bid": "bid-7e5e",
                            "tid": "tid-bbbb",
                            "device_sn": "3ABDQ12345678",
                            "level": 1,
                            "module": 3,
                            "message": "GPS signal is weak",
                            "status": 2,
                            "code": "drone_gps_weak",
                            "device_data_create_time": 1717530200000,
                            "device_data_update_time": 1717530250000,
                            "args": {
                                "satellite_count": 7
                            },
                            "device_type": "drone",
                            "domain_type": "drone",
                            "imminent": 0,
                            "in_the_sky": 1,
                            "joint_key": "drone.gps.weak",
                            "sub_hms_list": [],
                            "status_key": "drone.gps.weak.7"
                        }
                    ]
                }
            }
        ]
    }
}

🟠400

🔴500