Get All Drones Status

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

This API offers programmatic access to details about drones registered by users in AeroGCS Enterprise, including status and telemetry data. Integrate real-time drone information into your applications

Authentication

To use the API, insert your API key in the Authorization header like this:

Authorization: Bearer <YOUR_API_KEY>

Replace <YOUR_API_KEY> with your AeroGCS API key. Without it, you'll get 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

Response codes explanation

Code

Details

200

message: "ok"

400

request parameters missing

500

internal server error

Code Snippet

Examples of how you can call this API using curl, Node.js, and Python

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

//Please install 'axios' module first
//Set your API key before making the request
const axios = require('axios');

let config = {
  method: 'get',
  maxBodyLength: Infinity,
  url: 'https://ags.aeromegh.com/AeroMegh/getDronesStatus',
  headers: { 
    'Authorization': 'Bearer <API_KEY>'
  }
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

//Please install 'requests' package first
//Set your API key before making the request
import requests

url = "https://ags.aeromegh.com/AeroMegh/getDronesStatus"

payload = {}
headers = {
  'Authorization': 'Bearer <API_KEY>'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

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

API Response

Example of API Response in JSON format.

{
    "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

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

Parameter

Description

Sub-Parameters

drone_id

Unique identifier for the drone.

drone_name

Name assigned to the drone.

userid

Unique identifier for the user associated with the drone.

project

Project the drone is assigned to.

plan

Plan associated with the drone.

last_keep_alive

Timestamp indicating the last time the drone communicated its status.

last_tele_data

Information about the last telemetry data received from the drone, including a message and its type.

- message: Message received from the drone.

- type: Type of telemetry data (e.g., INFO).

total_flight_time

Total duration of flight recorded in hours, minutes, seconds, and milliseconds.

- hours: Total hours of flight.

- minutes: Total minutes of flight.

- seconds: Total seconds of flight.

- milliseconds: Total milliseconds of flight.

last_flight_log

Timestamp of the last recorded flight log.

flight_id

Unique identifier for the flight.

stream_key

Key for streaming data.

registered_date

Timestamp indicating the date and time when the drone was registered.

lease_drone

Indicates whether the drone is leased.

drone_rent

Rental fee for the drone.

dsp_drone_id

Identifier for the drone in the Digital Sky Platform.

uin

Unique Identification Number associated with the drone.

model

Model of the drone.

serial_no

Serial number of the drone.

fcsno

Flight Control System number.

rcsno

Remote Control System number.

board_type

Type of board used in the drone.

green_build_number

Build number for the green firmware.

device_ram

Amount of RAM available on the device.

android_version

Version of the Android operating system.

device_model_name

Name of the device model.

firmware_version

Version of the firmware installed on the drone.

license_type

Type of license associated with the drone.

topic

Topic associated with the drone.

status

Current status of the drone, including a message, type, and timestamp.

- message: Current status message (e.g., "Flight moving safely").

- type: Type of status message (e.g., INFO).

- timestamp: Timestamp of the status message.

online

Indicates whether the drone is online.

flightID

Unique identifier for the flight (alternative field).

teleData

Information about telemetry data received from the drone, including a message and its type (alternative field).

- message: Message received from the drone.

- type: Type of telemetry data (e.g., INFO).

PreviousGet All Drones NextGet All Flights

Last updated 6 months ago