1. Device List (Project Scope)
FlightHub 2 OpenAPI V2.0 (Public Cloud)
  • FlightHub 2 OpenAPI V2.0
    • Usage Guide
      • Authentication Tutorial
      • Error Code
    • Common
      • Common Tutorial
      • System Health & Access
        • Query FlightHub 2 System Status
        • Query System Health Status
        • Get Project Storage Upload STS Credentials
      • Security
        • SN Decrypt Echo
    • Organization & Project
      • Organization & Project Tutorial
      • Members & Permissions Management
        • Project Members
          • Add Members to Project
          • Get Project User List
          • Get Project Independent Member List
        • Organization Members
          • Get Organization User List
          • Get Current User's Organization Role
        • Roles & Permissions
          • Get Role List
          • Get Permission List
          • Get Role Permissions
      • Project Management
        • Project Collaboration
          • Get Project Quick-Join Information
        • Project Configuration
          • Get Auto Recording Config
        • Project Basic Info
          • Get Project List Under Organization
      • Organization Management
        • Organization Basic Info
          • Get Organization List
          • Get Organization Details
    • Device Management
      • Device Management Tutorial
      • Device List Management
        • Device List (Organization Scope)
          • Get Device List Under Organization
        • Device List (Project Scope)
          • Get Project Device Details
            GET
          • Get Project Device List
            GET
          • Update Device's Bound Project
            PUT
          • Get Project Device History Topology
            GET
      • Device Configuration
        • Calibration & Positioning
          • Custom Network RTK Calibration
        • Pairing Management
          • Query Relay Pairing Result
          • Make Device Enter Relay Pairing Mode
      • Get HMS Information
        GET
      • Acquire Control Permission
        POST
      • Release Control Permission
        DELETE
      • Live View Quality Settings
        PUT
      • Get Thing Model
        GET
    • Real-time Control
      • Real-time Control Tutorial
      • Control Permission Management
        • Device Control Permission
          • Query Device Control Status (Organization Device )
          • Query Device Control Status (Project Device)
        • Cloud Control Permission
          • Get Cloud Control Status
      • Payload Control
        • Camera Control
          • Aircraft Lens Switch
          • Dock Camera Switch
      • Flight Control Commands
        • General Real-time Commands
          • Query Device Command Execution
          • Send Real-time Control Command
      • Takeoff/Landing Coordination
        • Query Takeoff/Landing Coordination Area (TCA) Real-time Status
    • Livestream
      • Livestream Tutorial
      • Query Recording Tasks
        • Get Recording Tasks for Project Device
        • Get Recording Tasks for Organization Device
      • Livestream Sharing & Forwarding
        • Bypass Streaming
          • Create Stream Converter
          • Get Stream Converter List
          • Delete Stream Converter
          • Enable/Disable Stream Converter
        • Livestream Sharing
          • Get Device Livestream Share Details
          • Get Device Livestream Share List
      • Livestream Push
        • Start Livestream
    • Flight Task
      • Flight Task Tutorial
      • AI Flight Alerts
        • Query Flight Task Alert Records
        • Query AI Alert Records
      • Task Creation
        • Check Whether Flight Task Meets Dispatch Conditions
        • Create Flight Task
        • Resumable Immediate Task
      • Task Query
        • Get Recent Flight Task List
        • Get Default Task Name on Creation
        • Get Flight Task List
        • Get Flight Task Track Information
        • Get Wayline Task Details
        • Get Flight Task Information
        • Get Flight Task List
        • Get Media Resources from Flight Task
      • Flight Record
        • Get Export History
        • Get Single Flight Record Download Link
        • Get Wayline Task Operation Log
      • Task Update
        • Update Flight Task Status
    • Wayline
      • Wayline Tutorial
      • Wayline Management
        • Wayline Query
          • Get Wayline Details
          • Get Wayline List Under Project
        • Wayline Upload
          • Wayline Upload Completion Notification
    • Map
      • Map Tutorial
      • Map Annotation
        • Annotation Creation
          • Create Map Annotation
        • Annotation Update
          • Annotation Update
        • Annotation Deletion
          • Annotation Deletion
      • Airspace Safety
        • Terrain Obstacles
          • Get Offline Map URL
          • Get Offline Map Details
        • Custom Flight Area
          • Get Flight Area List (Workspace Scope)
          • Get Flight Area File URL
          • Get Flight Area List (Project Scope)
      • Airspace Warning
        • Airspace Warning
    • Model Reconstruction
      • Model Reconstruction Tutorial
      • Get Project Model List
      • Model Reconstruction
      • Get Model Details
      • Get Model File Download Link
    • Open Modeling
      • Open Modeling Tutorial
      • Start Reconstruction Task
      • Get Model Details
      • Delete Model
      • Stop Reconstruction Task
      • Get Resource Details
      • Delete Resource
      • Get Upload Credentials
      • Upload Callback
      • Get In-Progress Reconstruction Model Details
  1. Device List (Project Scope)

Get Project Device List

GET
/openapi/v2.0/project/device
Get the device list under the organization. Set the user key through the X-User-Token parameter in the Header, and set the project uuid through the X-Project-Uuid parameter in Headers; this interface will return the list of all devices under the specified project.
Use gateway: camera_list to obtain dock camera info, usable for Device Management: Dock Camera Switch.
Use drone: camera_list to obtain aircraft camera info, usable for Device Management: Aircraft Lens Switch.
camera_list is available only after the aircraft is powered on.
Currently returns information for up to 1000 devices.

Request

Header Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/openapi/v2.0/project/device' \
--header 'X-User-Token: {{X-User-Token}}' \
--header 'X-Project-Uuid: e7b81eec-f182-473a-9368-9e220e46f9d9' \
--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": "",
    "data": {
        "list": [
            {
                "gateway": {
                    "sn": "7CTDL9K00A0009",
                    "callsign": "220 FlightHub Dock 4",
                    "device_model": {
                        "key": "3-2-0",
                        "domain": "3",
                        "type": "2",
                        "sub_type": "0",
                        "name": "DJI Dock 2",
                        "class": "airport"
                    },
                    "device_online_status": true,
                    "mode_code": 0,
                    "camera_list": [
                        {
                            "camera_index": "165-0-7",
                            "available_camera_positions": [
                                "indoor",
                                "outdoor"
                            ],
                            "camera_position": "indoor"
                        }
                    ]
                },
                "drone": {
                    "sn": "1581F6Q8D241X00C87KJ",
                    "callsign": "",
                    "device_model": {
                        "key": "0-91-1",
                        "domain": "0",
                        "type": "91",
                        "sub_type": "1",
                        "name": "M3TD",
                        "class": "drone"
                    },
                    "device_online_status": false,
                    "mode_code": 14,
                    "camera_list": null
                }
            },
            {
                "gateway": {
                    "sn": "7CTDM3D00BZNVZ",
                    "callsign": "220-M3D",
                    "device_model": {
                        "key": "3-2-0",
                        "domain": "3",
                        "type": "2",
                        "sub_type": "0",
                        "name": "DJI Dock 2",
                        "class": "airport"
                    },
                    "device_online_status": false,
                    "mode_code": 1,
                    "camera_list": [
                        {
                            "camera_index": "165-0-7",
                            "available_camera_positions": [
                                "indoor",
                                "outdoor"
                            ],
                            "camera_position": "outdoor"
                        }
                    ]
                },
                "drone": {
                    "sn": "1581F6QAD238F0010264",
                    "callsign": "",
                    "device_model": {
                        "key": "0-91-0",
                        "domain": "0",
                        "type": "91",
                        "sub_type": "0",
                        "name": "M3D",
                        "class": "drone"
                    },
                    "device_online_status": false,
                    "mode_code": 14,
                    "camera_list": null
                }
            },
            {
                "gateway": {
                    "sn": "4SEDL9F0011RY2",
                    "callsign": "Dock 16",
                    "device_model": {
                        "key": "3-1-0",
                        "domain": "3",
                        "type": "1",
                        "sub_type": "0",
                        "name": "DJI Dock 1",
                        "class": "airport"
                    },
                    "device_online_status": false,
                    "mode_code": 3,
                    "camera_list": [
                        {
                            "camera_index": "165-0-7",
                            "camera_position": "indoor"
                        }
                    ]
                },
                "drone": {
                    "sn": "1581F5BLD22BE00A28X1",
                    "callsign": "",
                    "device_model": {
                        "key": "0-67-0",
                        "domain": "0",
                        "type": "67",
                        "sub_type": "0",
                        "name": "M30",
                        "class": "drone"
                    },
                    "device_online_status": false,
                    "mode_code": 0,
                    "camera_list": null
                }
            }
        ]
    }
}
🟠400
🟠401
🟠403
🔴500
Modified at 2026-05-26 14:32:15
Previous
Get Project Device Details
Next
Update Device's Bound Project
Built with