Get All Drones Status

This API is called to query all the registered drones of the user and retrieve their latest status.

This API provides programmatic access to information about a user's registered drones within the Aeromegh Ground Control System (GCS). It retrieves the latest status of each drone, including:

  • Online/Offline Status: Indicates whether the drone is currently communicating with the GCS.

  • Flight Status: Provides information about the drone's current flight activity (e.g., flying, landed, inactive).

  • Latest Telemetry Data Packet: Delivers the most recent telemetry data received from the drone, which may include details such as battery level, GPS location, and sensor readings.

This API allows developers to integrate real-time drone information into their applications.

Authentication with API Keys

This API uses API keys for authentication. To access the API, you'll need to include a valid API key in the Authorization header of your request using the Bearer token scheme. Here's the format:

Authorization: Bearer <YOUR_API_KEY>
  • Replace <YOUR_API_KEY> with your actual API key obtained from Aeromegh.

  • Requests without a valid API key will result in a 401 Unauthorized error.

Method

GET : retrieves the status of all drones.

HTTP Request

https://ags.aeromegh.com/AeroMegh/getDronesStatus

Headers: "authorization": "Bearer <API_key>"

HTTP Response

The API responds with the list of all the registered drones of the user along with their latest flight status, flight location and online/offline status.

Response codes explanation

Code Snippet

Take a look at how you might call this method using our official libraries, or via curl:

curl --location 'https://ags.aeromegh.com/AeroMegh/getDronesStatus' \
--header 'Authorization: Bearer <API_KEY>'

Note: Replace <API_KEY> with the actual API_KEY provided by Aeromegh.

API Response

The API response provides detailed information about each drone registered in the system. Below is an example of the JSON response containing data for multiple drones:

{
    "drones": [
        {
            "drone_id": "P000010024003B3131510137383337",
            "drone_name": "KAM29032024",
            "userid": "598cc675-8126-4d62-be60-03c8d4b5e62b",
            "project": "ManualProject",
            "plan": "SprayingPlan",
            "last_keep_alive": "2024-05-06T10:37:39.645Z",
            "last_tele_data": "{\"message\":\"Disarming Motors\",\"type\":\"INFO\"}",
            "total_flight_time": {
                "hours": 4,
                "minutes": 50,
                "seconds": 56,
                "milliseconds": 744
            },
            "last_flight_log": null,
            "flight_id": "f45c2575-c5f4-4323-baf3-7e719e3c8059",
            "stream_key": "",
            "registered_date": "2024-03-29T06:46:45.691Z",
            "lease_drone": false,
            "drone_rent": "0",
            "dsp_drone_id": null,
            "uin": "dfgdfgfg",
            "id": "ba3c252a-e624-4850-9cf7-6845ba9af631",
            "model": null,
            "serial_no": null,
            "fcsno": "1234",
            "rcsno": "MK15",
            "board_type": null,
            "green_build_number": null,
            "device_ram": null,
            "android_version": null,
            "device_model_name": null,
            "firmware_version": null,
            "license_type": null,
            "topic": "rbxx6tw60sjf24snu3zot97t31s5rt2gnec2qcwtkk3yw06j91jrwa563116ai07",
            "status": "{\"type\":\"INFO\",\"message\":\"Flight moving safely\",\"timestamp\":1715325835.472}",
            "online": false,
            "flightID": "f45c2575-c5f4-4323-baf3-7e719e3c8059",
            "teleData": {
                "message": "Disarming Motors",
                "type": "INFO"
            }
        },
        {
            "drone_id": "P00001DESKTOP-QFR1AP5",
            "drone_name": "Abhishek",
            "userid": "598cc675-8126-4d62-be60-03c8d4b5e62b",
            "project": "ManualProject",
            "plan": "SprayingPlan",
            "last_keep_alive": "2024-04-27T07:02:06.951Z",
            "last_tele_data": "{\"message\":\"Disarming Motors\",\"type\":\"INFO\"}",
            "total_flight_time": {
                "seconds": 8,
                "milliseconds": 80
            },
            "last_flight_log": null,
            "flight_id": "a043e414-664a-4369-8201-8bc5e3886195",
            "stream_key": "",
            "registered_date": "2024-04-26T09:58:09.562Z",
            "lease_drone": false,
            "drone_rent": "0",
            "dsp_drone_id": null,
            "uin": "fyuiighj",
            "id": "7efc6dcf-93ad-44ce-8fa0-8d0a85c50e89",
            "model": null,
            "serial_no": null,
            "fcsno": "",
            "rcsno": "",
            "board_type": null,
            "green_build_number": "102.257.20240419.01",
            "device_ram": "5.73 GB",
            "android_version": "Android 14",
            "device_model_name": "Realme RMX3710",
            "firmware_version": "ArduCopter V4.5.1 (913ec4b2)",
            "license_type": "15 Days Trial",
            "topic": "cbglr44gomuslhdslyyrklvopwigwew0059c0pbln5evwt7mu5hz8rlh4zui5ewd",
            "status": "{\"type\":\"INFO\",\"message\":\"Flight moving safely\",\"timestamp\":1715325835.472}",
            "online": false,
            "flightID": "a043e414-664a-4369-8201-8bc5e3886195",
            "teleData": {
                "message": "Disarming Motors",
                "type": "INFO"
            }
        },
        {
            "drone_id": "P00001004C00333032511433383839",
            "drone_name": "mo-hit",
            "userid": "598cc675-8126-4d62-be60-03c8d4b5e62b",
            "project": "2",
            "plan": "2",
            "last_keep_alive": "2024-04-15T12:31:55.537Z",
            "last_tele_data": "{\"message\":\"Disarming Motors\",\"type\":\"INFO\"}",
            "total_flight_time": {
                "minutes": 12,
                "seconds": 42,
                "milliseconds": 55
            },
            "last_flight_log": null,
            "flight_id": "6ba9d881-2552-4cbe-9017-592b1d7305e2",
            "stream_key": "",
            "registered_date": "2024-04-15T12:08:00.734Z",
            "lease_drone": false,
            "drone_rent": "0",
            "dsp_drone_id": null,
            "uin": ".......",
            "id": "ab406ac3-4253-45c0-94e3-b1318b7d0cdb",
            "model": null,
            "serial_no": null,
            "fcsno": "",
            "rcsno": "",
            "board_type": "CubeOrangePlus",
            "green_build_number": "101.221.20240405.01",
            "device_ram": "11.22 GB",
            "android_version": "Android 14",
            "device_model_name": "OnePlus CPH2415",
            "firmware_version": "ArduCopter V4.4.4",
            "license_type": "OEM",
            "topic": "67b6sqxemr1m6bqtcd4o49r95uz7egpkp347w9hg43cfndfp6n4k005j6w4vaggt",
            "status": "{\"type\":\"INFO\",\"message\":\"Flight moving safely\",\"timestamp\":1715325835.472}",
            "online": false,
            "flightID": "6ba9d881-2552-4cbe-9017-592b1d7305e2",
            "teleData": {
                "message": "Disarming Motors",
                "type": "INFO"
            }
        }
    ]
}

API Response Parameter Details

The following table outlines the parameters included in the API response for each drone:

Last updated