Getting Started
All the info you need to get up and running using the Bluesonde API
Welcome to the Bluesonde API documentation! Throughout the following pages, you’ll learn all the information you need to make your first request.
First things first, you’ll need an account to access the Bluesonde Dashboard. If you have one, log in to the dashboard, otherwise, create an account.
To provision the resources necessary to access the API, your account will need to at least have the role Organization Admin. If you do not have this role, get in touch with your organization administrator, or reach out to us.
Once you’ve created an account, provision an access token. You can do this by following the steps in Access & Authentication.
With an access token provisioned, you’re ready to send your first request! Simply place the token in the HTTP Authorization header (e.g. Authorization Bearer <token>), and fire away! Some example endpoints are listed below:
GET https://bluesonde.io/api/v0/devicesGET https://bluesonde.io/api/v0/observationsGET https://bluesonde.io/api/v0/sensorsIf you’re interested in getting data in an asynchronous way, check out the section on Webhooks. If you’d like to know more about the entities you’ll encounter using our API, check out the Data section.
