Query Organization Device Command Execution Progress - FlightHub 2 OpenAPI V2.0 (On-Premises)

Progress query API for generic cmds channel. Can simultaneously query multiple devices' command execution status, progress percentage, device-reported error codes, extension data, etc. under specified {method}; used for client polling to display device command execution (Cover Opening, Uploading Logs, Network Speed Testing, etc.). This API is paired with POST /manage-devices/cmds/{method} ("Dispatch Custom Command to Organization Device (Generic cmds Channel) [Query-Type Developed as API, Configuration-Type Retained]" API — Dispatch Command): caller polls via this API after obtaining bid until status becomes ok / failed / timeout / canceled. services is dynamic key map: key is method name (consistent with method in path, e.g. set_ntp_conf / cover_open); value is the method's progress details; structure is uniform across all methods. When identifiers is omitted, uses method in path as single-value filter condition; explicit identifiers in query has higher priority.

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200

application/json

Success Response

Bodyapplication/json

Example

{
    "code": 0,
    "message": "OK",
    "data": {
        "list": [
            {
                "sn": "3ABDQ12345678",
                "services": {
                    "cover_open": {
                        "bid": "h92f9i77-3k56-9g8h-46i2-k6j5378f0h66",
                        "status": "ok",
                        "create_time": 1717574400000,
                        "update_time": 1717574420000,
                        "progress": {
                            "percent": 100,
                            "current_step": 1
                        },
                        "device_code": 0,
                        "ext": {}
                    },
                    "drone_open": {
                        "bid": "i03g0j88-4l67-0h9i-57j3-l7k6489g1i77",
                        "status": "in_progress",
                        "create_time": 1717574460000,
                        "update_time": 1717574475000,
                        "progress": {
                            "percent": 50,
                            "current_step": 1
                        },
                        "device_code": 0,
                        "ext": {}
                    }
                }
            },
            {
                "sn": "2TUDK87654321",
                "services": {
                    "fileupload_list": {
                        "bid": "k25i2l00-6n89-2j1k-79l5-n9m8601i3k99",
                        "status": "ok",
                        "create_time": 1717574400000,
                        "update_time": 1717574520000,
                        "progress": {
                            "percent": 100,
                            "current_step": 2
                        },
                        "device_code": 0,
                        "ext": {
                            "files": [
                                {
                                    "name": "log_20240605_120000.tar.gz",
                                    "size": 12582912
                                },
                                {
                                    "name": "log_20240605_130000.tar.gz",
                                    "size": 8388608
                                }
                            ]
                        }
                    }
                }
            }
        ]
    }
}

🟠400

🔴500