Introduction to REST API
Our REST API can be used to programmatically interact with our services. For instance, DT Studio, our easy-to-use device management web-app, is itself entirely built upon the REST API. Therefore, everything you can do in DT Studio, from moving devices between projects and managing Service Accounts, can also be done via our REST API.
The only thing you need to get started using our REST API is a Service Account with sufficient permissions for the task you want to do. While subsequent Service Accounts can be managed through the REST API itself, the initial account must be set up using DT Studio as a point of entry.
Read our guide on Creating a Service Account to get started.
Once in the possession of a Service Account, depending on the permissions granted, a comprehensive list of every endpoint available can be found in our REST API Reference.
All our REST API calls are extensions of a base URL that can be used in both long- and short-form.
https://api.d21s.com/v2https://api.disruptive-technologies.com/v2
This is also true for our Sensor Emulator API, an extension for the main REST API under a separate URL.
https://emulator.d21s.com/v2https://emulator.disruptive-technologies.com/v2
Our REST API supports two methods of authentication, both using a Service Account for access control.
Basic Auth: A simple username- and password-style authentication, handy for quick prototyping.
OAuth2 Flow: A robust exchange of credentials for an access token used to authenticate.
We recommend using the OAuth2 authentication flow when integrating with our REST API. Once implemented, OAuth2 makes sending HTTP Requests both simple and secure.
Head over to our REST API Authentication section to get started.
