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:
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
Note: Replace <API_KEY>
with the actual API_KEY provided by Aeromegh.
API Response
Example of API Response in JSON format.
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). |
Last updated