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 thispublishing live data,traffic, drones become visible within the SafeSky network, promoting safer integration with other airspace users.

The typical approach is to PUSH one or multiple live traffic data in a batch. In response, the system returns traffic in the vicinity of all UAVs within a default radius. This method is the most efficient way to avoid polling unnecessary traffic, ensuring optimal performance.

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

For data sources that do notdon’t provide live telemetry, the API supportsallows the submission of advisory messages.messages These messagesto define active drone activitiesoperations using either polygons or circles, accompaniedalong bywith a maximum altitude. This feature ensures that planned or ongoing drone operationsactivities are communicatedvisible effectively,within the SafeSky network, even inwhen thereal-time absencetelemetry ofdata liveisn’t telemetry.available.

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