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

Get the list of devices under the organization

Developing
GET
/openapi/v0.1/device
Obtain the list of devices under the organization. Set the user key through the X-User-Token parameter in the Header. This interface will return the list of all devices under the organization corresponding to the user key.
You can obtain camera information of the dock 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

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/device' \
--header 'X-Request-Id;' \
--header 'X-Language: zh'

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": 1,
              "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 projects under the organization
Next
Obtain the list of devices under the project
Built with