go-skydio

A golang SDK for the Skydio Cloud API.

Skydio Cloud allows you to manage your Skydio vehicles using Fleet Manager and Media Sync to provide automatic media and flight data uploads.

Installation

go-skydio is compatible with Go releases in module mode:

go get -u github.com/justinsimmons/go-skydio

Usage

First initialize a Skydio API client. This will allow you to interface with the API in an easy manner.

import "github.com/justinsimmons/go-coinbase"

func main() {
    token := "super secret API token"

    client := skydio.NewAuthenticatedClient(token)
}

Once you have the client you can perform any of the various API operations:

    client := skydio.NewAuthenticatedClient(token)

    // Retrieve a flight by its identifier.
    flight, err := client.Flights.Get(context.TODO(), "flight-id")
    if err != nil {
        return nil, err
    }

Some API methods have optional parameters that can be passed. For example:

    client := skydio.NewAuthenticatedClient(token)

    // Optional parameters that can filter the results.
    opts := &skydio.QueryVehiclesOptions {
        UserEmail: "[email protected]" // Return vehicles belonging to this user.
    }

    // The list vehicles API is paginated so it will return a Pagination struct.
    // This can be used to enumerate the results, for an example see the
    // pagination section below.
    vehicles, page, err := client.Vehicles.Query(context.TODO(), opts)
    if err != nil {
        return err
    }

The services of the client divide the API into logical chunks and correspond to the structure of the Skydio Cloud API documentation.

NOTE: Using the context package, one can easily pass cancellation signals and deadlines to various services of the client for handling a request. In case there is no context available, then context.Background() can be used as a starting point.

Authentication

Interacting with the Skydio API requires an API Token for both authenticating and authorizing requests.

To create an API token follow Skydio's instructions located here.

Once you have the API token you can supply it to the Go Skydio client one of two ways. Both are equivalent.

// This is your API token.
token := "super secret"

// You can pass the API token in directly as an option to the constructor.
client := skydio.NewClient(skydio.WithApiToken(token))

// Or you can use the provided convenience function:
client = skydio.NewAuthenticatedClient(token)

Error Handling

The client makes use of sentinel errors as return values. This allows you to take advantage of the native Go error comparison via the errors package:

serialNumber := "Vehicle Serial #"

vehicles, page, err := client.Vehicles.Get(context.TODO(), serialNumber)
if err != nil {
    if errors.Is(err, skydio.ErrVehicleNotFound) {
        // Perform custom logic here...
    }

    // Handle generic API error.
    return err
}

This is not recommended but if you would like even more fine grained information about the error you can use a type assertion:

    apiErr, ok := err.(*skydio.ApiError)
    if !ok {
        // This is not a Skydio API error. ONLY API responses from Skydio
        // yield a skydio.ApiError.
        // As is the case if the HTTP request fails to generate etc.
        return
    }

    fmt.Println(apiErr.Code) // EX: 4200
    fmt.Println(apiErr.Message) // EX: "Vehicle not found."
    fmt.Println(apiErr.HttpStatusCode) // EX: 404

    // You can even have deeper access to the exact API response received from
    // the Skydio API.
    resp, ok := apiErr.(*skydio.ApiResponse[any])
    if !ok { /* .... */ }

    fmt.Println(resp.Data) // EX: {}
    fmt.Println(resp.Meta) // EX: {}

Pagination

All requests for resource collections (flights, mission, vehicles, etc.) support pagination.

client = skydio.NewAuthenticatedClient(token)

opts := &skydio.QueryFlightsOptions{
    PerPage: 50, // Number of results to return per page.
}

// Slice of all pages of results.
var allFlights []skydio.Flight

for {
    flights, page, err := client.Flights.Query(
        context.TODO(),
        opts,
    )
    if err != nil {
        return err
    }

    allFlights = append(allFlights, flights...)

    // If there are no more pages break.
    if !page.HasNext() {
        break
    }

    opts.NextPage = page.PageNumber + 1
}

License

Copyright 2025 Justin Simmons.

This program is released under the BSD-style license found in the LICENSE file.