Skip to main content

Overview

Introduction

The SafeSky UAV API offers a comprehensive solution for drone operators and manufacturers to enhance situational awareness by managing two distinct types of drone traffic data:

  1. Live UAV Operations: /v1/uav

This set of API endpoints allows users to publish real-time telemetry data of their drones, including position, altitude, and velocity. By sharing this live data, drones become visible within the SafeSky network, promoting safer integration with other airspace users.

  1. Advisory UAV Operations: "/v1/advisory"

For data sources that do not provide live telemetry, the API supports the submission of advisory messages. These messages define active drone activities using either polygons or circles, accompanied by a maximum altitude. This feature ensures that planned or ongoing drone operations are communicated effectively, even in the absence of live telemetry.

Authentication

The SafeSky API is accessible via a standard REST API, enabling seamless integration with your applications. To start using the API:

  1. Get an API Key:
    Visit SafeSky and subscribe to the desired plan.

  2. Make API Calls:
    Use the endpoints provided, including the appropriate parameters in your requests. All responses are returned in JSON format.

  3. Authentication:
    Authentication is automatically managed when making requests with your API key.
    Important: Never disclose your API key and take all necessary security measures to protect it.

Endpoints

SafeSky provides two API endpoints for different purposes: Sandbox and Production. Each endpoint requires a separate API key, which ensures appropriate access levels for testing and live environments.

Sandbox

The sandbox environment is designed for development and integration testing. It allows you to test API calls and functionalities without affecting the live production data.

  • Key Features:

    • Simplified environment with limited traffic data.
    • Ideal for debugging, testing payloads, and verifying integration.

  • Endpoint URL: https://sandbox-public-api.safesky.app

  • API Key: You will receive a sandbox-specific API key upon registration. Ensure this key is used exclusively for sandbox testing.

Production

The production environment is the live SafeSky API, providing real-time and unfiltered access to traffic data. This environment is intended for operational use and live deployments.

  • Key Features:

    • Access to all real-time traffic data, including manned and unmanned aircraft.
    • Supports high-availability operations with optimized performance for production workloads.

  • Usage Guidelines:

    • Ensure robust error handling and retry mechanisms in your application.
    • Follow the recommended request limits to avoid throttling.

  • Endpoint URL: https://public-api.safesky.app

  • API Key: A production-specific API key is required. This key must not be shared and should be stored securely following best practices (e.g., environment variables or secret management systems).

Check for API health

Endpoint: GET /
Description:
Provides health checks against the API. Returns the string 'UP' if network services are up and running.

Support

For assistance or further inquiries, please contact us at support@safesky.app or visit our website.

Back to top