1. Organize Projects
NEW FlightHub 2 OpenAPI V1.0
  • Root Directory
    • authentication
      • Authentication Tutorial
    • System Service
      • Query FlightHub 2 system status
    • Organize Projects
      • Organize Project Tutorial
      • Get the list of projects under the organization
        GET
      • Get the list of devices under the organization
        GET
      • Obtain the list of devices under the project
        GET
      • Obtain storage upload credentials for the project
        GET
      • Add personnel to the project
        PUT
    • Device Management
      • Device Management Tutorial
      • Device Model Retrieval
      • HMS Information Retrieval
      • Real-time control command distribution
      • Dock camera switch
      • Aircraft Lens Switching
      • Control acquisition
      • Release control
      • Video transmission clarity settings
      • Custom Network RTK Calibration
    • Livestream Management
      • Livestream Management Tutorial
      • Livestream Push
        • Start livestream
      • Bypass Streaming
        • Stream forwarding error code
        • Create Stream Forwarder
        • Enable/Disable stream forwarder
        • Get stream transcoder list
        • Delete stream forwarder
    • Task Management
      • Task Management Tutorial
      • Create Flight Task
      • Updated flight task status
      • Obtain flight task list
      • Obtain media resources generated by the Flight task
      • Obtain Flight task trajectory information
      • Obtain Flight task information
    • Flight Route Management
      • Flight Route Management Tutorial
      • Flight Route Upload Completion Notification
      • Get the list of flight routes under the project
      • Get flight route details
    • Model Management
      • Model Management Tutorial
      • Model reconstruction coordinate system
      • Get the list of models under the project
      • Get Model Details
      • Model reconstruction
    • Annotation Management
      • Annotation Management Tutorial
      • Create map annotation
    • Open modeling
      • Open modeling tutorial
      • Model Reconstruction Error Code
      • Release Notes
      • Algorithm parameter introduction
      • Get resource details
      • Get Details of Models Currently Being Reconstructed
      • Get upload credential
      • Upload callback
      • Delete resource
      • Start reconstruction task
      • Stop reconstruction task
      • Get the Model Details
      • Delete Models
  • Schemas
    • 默认目录
      • 公共结构
    • 硬件设备
    • 实时应用
    • real-time application
    • Root Table of Contents
      • Default Table of Contents
        • Public Structure
      • Hardware device
        • Dock 3
        • Matrice 4D Series
        • Dock 1
        • Matrice 30 Series
        • Dock 2
        • Matrice 3D Series
        • DJI RC Plus 2
        • Mavic 3 Enterprise Series
        • DJI RC Pro Enterprise
        • Matrice 300 RTK
        • Matrice 350 RTK
        • Matrice 4 Series
        • DJI Smart Controller Enterprise
        • DJI RC Plus
      • 实时应用
      • real-time application
        • schema_option_rmtp
        • schema_option_gb28181
        • task_repeat_option_relative_monthly
        • task_repeat_option_absolute_monthly
        • task_repeat_option_weekly
        • task_repeat_option_daily
  1. Organize Projects

Obtain the list of devices under the project

Developing
GET
/openapi/v0.1/project/device
Get the list of devices 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 the Headers. This interface will return the list of all devices under the specified project.
Can be switched through gateway: camera_list for device management: Dock camera switching.
You can obtain aircraft camera information through drone: camera_list for device management: Dock Lens Switching.
The camera_list information can only be obtained after the aircraft is powered on.
Currently, information for up to 1000 devices can be returned.

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/v0.1/project/device' \
--header 'X-Request-Id;' \
--header 'X-Language: zh' \
--header 'X-Project-Uuid: {{X-Project-Uuid}}'

Responses

🟢200Success
application/json
Bodyapplication/json

Example
{
    "code": 0,
    "message": "OK",
    "data": {
        "list": [
            {
                "gateway": {
                    "sn": "7CTDM3D00BZNVZ",
                    "callsign": "Test Dock",
                    "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": 2,
                    "camera_list": [
                        {
                            "available_camera_positions": [
                                0,
                                1
                            ],
                            "camera_position": "outdoor",
                            "camera_index": "165-0-7"
                        }
                    ]
                },
                "drone": {
                    "sn": "1581F6Q8D242100CPWEK",
                    "callsign": "",
                    "device_model": {
                        "key": "0-91-1",
                        "domain": "0",
                        "type": "91",
                        "sub_type": "1",
                        "name": "M3TD",
                        "class": "drone"
                    },
                    "device_online_status": true,
                    "mode_code": 0,
                    "camera_list": [
                        {
                            "camera_index": "81-0-0",
                            "lens_list": [
                                {
                                    "available_lens_types": [
                                        "normal",
                                        "wide",
                                        "zoom",
                                        "ir"
                                    ],
                                    "lens_type": "wide"
                                }
                            ]
                        }
                    ]
                }
            }
        ]
    }
}
Modified at 2025-04-28 12:08:39
Previous
Get the list of devices under the organization
Next
Obtain storage upload credentials for the project
Built with