Get Flight Task Device Recommendation Result

POST

/openapi/v2.0/task/api/v1/workspaces/{workspace_id}/flight-tasks/device-recommendation

By business scenario (Point-to-Fly / Normal Wayline Takeoff / Leapfrog Wayline / Dual-Aircraft Relay / Base Station Recommendation / Emergency Response, and other 8 strategies) + start/end positions, reverse-derives available "dock + aircraft" combinations within project and provides reachability/distance scoring; for selecting execution devices when creating immediate or wayline tasks. Caller: Logged-in project member. Returns: device recommendation list sorted by reachability/distance; returns empty array (not treated as error) when no available devices in project.

Request

Path Params

Header Params

Body Params application/jsonRequired

Example

{
    "strategy_id": 1,
    "fly_to_position": {
        "latitude": 22.50203,
        "longitude": 113.94186,
        "height": 100
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/openapi/v2.0/task/api/v1/workspaces//flight-tasks/device-recommendation' \
--header 'x-user-token;' \
--header 'x-user-token;' \
--header 'X-Request-Id: 5dff27bd-693c-4ace-979d-e26e920d497a' \
--header 'X-Request-Id;' \
--header 'X-Project-Uuid;' \
--header 'Content-Type: application/json' \
--data '{
    "strategy_id": 1,
    "fly_to_position": {
        "latitude": 22.50203,
        "longitude": 113.94186,
        "height": 100
    }
}'

Responses

🟢200

application/json

Operation Successful

Bodyapplication/json

Example

{
    "code": 0,
    "message": "success",
    "data": {
        "devices": [
            {
                "drone_sn": "1ZNBJ5D0030S2P",
                "gateway_sn": "8UUDMAQ00A0152",
                "distance": 1240.5,
                "matched": true
            },
            {
                "drone_sn": "1ZNBJ5D0030S3K",
                "gateway_sn": "8UUDMAQ00A0301",
                "distance": 2860.1,
                "matched": false
            }
        ]
    }
}

🟠400

🔴500

Modified at 2026-06-15 13:36:31

Control Wayline Task (Pause / Resume / Cancel)

Fly to Target Point (One-Click Takeoff)