Testing the REST API with a demo project

Download as PDF

If you don’t have any Consibio devices yet but still want to test an integration with our API, you can do it using a demo project with simulated data.

Set up the demo project

Sign up for a new account at https://v3.consibio.cloud/signup, using the email address you want to authenticate with (for example a service account). You’ll need to verify the email address, so use one you have access to.
Sign in at https://v3.consibio.cloud with the new account.
A demo project with simulated data is created automatically the first time you sign in. Open it from the project overview.
The project shows mock data, such as a simulated temperature curve. Copy the project ID from the browser’s address bar — you’ll need it for API calls:
```
https://v3.consibio.cloud/projects/<project_id>/devices
```

Test the API

With the demo project’s ID, the normal workflow for retrieving telemetry datalogs is:

Authenticate — request a token from the login endpoint using the new account’s credentials:
```
POST https://api.v2.consibio.cloud/login
```
List elements (if you don’t already know the element IDs — the unique tags associated with each measurement):
```
GET https://api.v2.consibio.cloud/projects/<project_id>/elements
```

Request datalogs for the element IDs you want:

GET https://api.v2.consibio.cloud/projects/<project_id>/datalog?elements=<element_id_1>;<element_id_2>&from_time=<unix_timestamp>&to_time=<unix_timestamp>

For the full request/response details, see the interactive API docs at https://api.v2.consibio.cloud/api-docs/, or the walkthrough in Pulling datalogs with the REST API.

Support

Questions about testing the API? Contact support@consibio.com.