Get Project Device Thing Model - FlightHub 2 OpenAPI V2.0 (On-Premises)

Returns complete topology structure and real-time thing model status of currently online and offline-pending devices in project. ### Topology Structure Each topology record is grouped by device role:

host — Center node (usually aircraft); null if topology has no aircraft

parents — Gateway nodes (Remote Controller, Dock, Base Station)

nodes — Child nodes (Relay devices, etc.) ### Thing Model Data Each device node's device_state contains the device's real-time thing model attributes. Structure determined by device_model.key (format {domain}-{type}-{sub_type}); different models return different attribute sets. device_state is null when device is offline. ### Filter Rules Server automatically filters following devices, not returned in results:

Topologies with only remote controllers and no aircraft

Non-dock/non-aircraft/non-relay/non-base-station devices completely offline for more than 5 minutes

Offline aircraft whose topology does not contain dock or base station ### Call Conditions Caller must be member of the project.

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200

application/json

Successfully Returned Project Device Topology List

Bodyapplication/json

Example

{
    "code": 0,
    "message": {
        "chinese": "Success",
        "english": "OK"
    },
    "data": {
        "list": [
            {
                "index": "a3f5c7d28b9e4f1ab2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5",
                "host": {
                    "device_sn": "1581F5FKD232800D378V",
                    "device_model": {
                        "key": "0-91-0",
                        "domain": "0",
                        "type": "91",
                        "sub_type": "0",
                        "name": "Matrice 3D",
                        "class": "drone"
                    },
                    "device_online_status": true,
                    "is_device_pending_offline": false,
                    "device_offline_position": null,
                    "device_project_callsign": "Inspection Drone 01",
                    "is_organization_device": true,
                    "device_organization_callsign": "Factory East Side",
                    "device_control_user_id": "",
                    "device_control_user_project_callsign": "",
                    "device_control_user_organization_callsign": "",
                    "device_state": {
                        "firmware_version": "08.01.0205",
                        "longitude": 113.947593,
                        "latitude": 22.563281,
                        "height": 50.3,
                        "attitude_pitch": -2.1,
                        "attitude_roll": 0.3,
                        "attitude_head": 135,
                        "elevation": 48.7,
                        "horizontal_speed": 5.2,
                        "vertical_speed": 0,
                        "battery_capacity_percent": 78,
                        "gear": "landing_gear_up"
                    },
                    "device_index": "",
                    "parent_sns": [
                        "7CTDM2D00B00AK"
                    ]
                },
                "parents": [
                    {
                        "device_sn": "7CTDM2D00B00AK",
                        "device_model": {
                            "key": "3-3-0",
                            "domain": "3",
                            "type": "3",
                            "sub_type": "0",
                            "name": "DJI Dock 3",
                            "class": "airport"
                        },
                        "device_online_status": true,
                        "is_device_pending_offline": false,
                        "device_offline_position": null,
                        "device_project_callsign": "East Side Dock",
                        "is_organization_device": true,
                        "device_organization_callsign": "Factory East Dock",
                        "device_control_user_id": "",
                        "device_control_user_project_callsign": "",
                        "device_control_user_organization_callsign": "",
                        "device_state": {
                            "firmware_version": "02.01.0603",
                            "longitude": 113.94758,
                            "latitude": 22.56329,
                            "mode_code": "idle",
                            "cover_state": "closed",
                            "putter_state": "idle",
                            "supplement_light_state": "off",
                            "network_state_type": "ethernet",
                            "battery_store_mode": "plan_mode",
                            "drone_charge_state_capacity_percent": 100,
                            "drone_in_dock": true,
                            "rainfall": "none",
                            "wind_speed": 3.2,
                            "environment_temperature": 28.5,
                            "environment_humidity": 65
                        },
                        "device_index": "",
                        "parent_sns": []
                    }
                ],
                "nodes": []
            }
        ]
    }
}

🟠400

🔴500