NEW FlightHub 2 OpenAPI V1.0
  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
  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
X-Request-Id
string <uuid>
required
Request Unique Identifier
X-Language
enum<string> 
optional
Allowed values:
zhen
Default:
zh
X-Project-Uuid
string 
optional
Project Number
Default:
{{X-Project-Uuid}}

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

Responses

🟢200Success
application/json
Body
code
integer 
required
Non-zero indicates an exception
message
string 
required
Message prompt
data
object 
required
list
array [object {2}] 
required
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"
                                }
                            ]
                        }
                    ]
                }
            }
        ]
    }
}
Previous
Get the list of devices under the organization
Next
Obtain storage upload credentials for the project
Built with