REST API

The HTTP REST API is the primary way to interact with the Dromt platform. It is used to create and manage resources such as drones, missions, and users. It is available at https://api.stream.dromt.it.

API Reference

Platform

Authentication

To authenticate with the API, you need to provide a valid authentication token. This token needs to be provided in the Authentication header of the request in the following format:

Authentication: Bearer <your token>

You can get a token for testing purposes by logging in to the web interface and then retrieving it from the browser’s local storage. The token is stored in the auth_access_token key.

Alternatively, you can use the Amazon Cognito APIs to authenticate and get a token. The following example uses the AWS CLI to authenticate and get a token:

aws cognito-idp initiate-auth \
    --auth-flow USER_PASSWORD_AUTH \
    --auth-parameters USERNAME=<your username>,PASSWORD=<your password> \
    --client-id <your client id> \
    --region <your region>

Contact us to get your client id and region.

Organization

In the Dromt platform, an organization is a group of users that share a common set of resources. Each user can belong to multiple organizations. The organization is the main unit of access control in the platform. Users can be granted access to resources in an organization by assigning them a read or write role.

If a request does not specify an organization, it is assumed to be in the user’s default organization (the private organization that is created for each user).

You can specify the organization in the Organization header of the request in the following format:

Organization: <your organization id>