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 History Topology

GET
/openapi/v2.0/topologies/history
Get the project's historical device topology, grouped by model into dock/remote controller/aircraft nodes. This interface is for historical display only, and all nodes' online status is always false

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/topologies/history' \
--header 'X-User-Token: {{X-User-Token}}' \
--header 'X-Project-Uuid: 78fec78d-4ef4-488d-90d3-9ff83659598c' \
--header 'X-Request-Id: {{$string.uuid}}' \
--header 'X-Request-Id: {{$string.uuid}}' \
--header 'X-Language: zh' \
--header 'X-Language: zh'

Responses

🟢200
application/json
OK
Bodyapplication/json

Example
{
    "code": 0,
    "message": "success",
    "data": {
        "list": [
            {
                "index": "1b3e4cf6d4a1c2f9e8b7a6d5c4f3e2b1a0d9c8b7a6e5f4d3c2b1a09e8f7d6c5b",
                "host": {
                    "device_sn": "7CTDL9K00A0035",
                    "device_model": {
                        "key": "0-89-0",
                        "domain": "0",
                        "type": "89",
                        "sub_type": "0",
                        "name": "M3D Series",
                        "class": "drone"
                    },
                    "device_online_status": false,
                    "is_device_pending_offline": false,
                    "device_offline_position": null,
                    "device_project_callsign": "",
                    "is_organization_device": true,
                    "device_organization_callsign": "Org Callsign - Aircraft 1",
                    "device_control_user_id": "1959900546305060880",
                    "device_control_user_project_callsign": "User A - Project Callsign",
                    "device_control_user_organization_callsign": "",
                    "device_state": null,
                    "device_index": "",
                    "parent_sns": []
                },
                "parents": [
                    {
                        "device_sn": "8UUDM9K00A0010",
                        "device_model": {
                            "key": "2-90-0",
                            "domain": "2",
                            "type": "90",
                            "sub_type": "0",
                            "name": "DJI Dock 3",
                            "class": "airport"
                        },
                        "device_online_status": false,
                        "is_device_pending_offline": false,
                        "device_offline_position": null,
                        "device_project_callsign": "",
                        "is_organization_device": true,
                        "device_organization_callsign": "Org Callsign - Dock A",
                        "device_control_user_id": "",
                        "device_control_user_project_callsign": "",
                        "device_control_user_organization_callsign": "",
                        "device_state": null,
                        "device_index": "",
                        "parent_sns": []
                    }
                ],
                "nodes": [],
                "project": {
                    "uuid": "fc2e29b6-f118-4d2c-93f2-717dc6ae1f6a",
                    "name": "Example Project"
                }
            }
        ]
    }
}
🟠400
🟠401
🟠403
🔴500
Modified at 2026-05-26 14:32:15
Previous
Update Device's Bound Project
Next
Custom Network RTK Calibration
Built with