Infrastructure

This page details the steps that the user can follow to generate an infrastructure which will able their sensors to upload data through Airtrace to the Blockchain.

Infrastructure tab

When creating a new Deployment or editing any Deployment via the website, inside the "Infrastructure" tab the user can find all the custom API links that are automatically generated.

The infrastructure tab contains the API endpoint where the user can authenticate (obtain an authentication token), as well as the endpoints where the data for any user's sensor will be uploaded to Airtrace.

Infrastructure tab

In order for the user's sensors to upload the data they register, first they need to be identified. The user needs to create and assign an identity for every sensor that is already associated with a project or Deployment. These steps are detailed in Identities.

Generating the infrastructure

Once the user has assigned identities to all of the sensors in a Deployment or Plain Project, a new infrastructure will be generated for the user, this infrastructure contains all of the links where the user's sensors will upload the data, as well as the endpoint where the user can obtain a new Bearer token.

Clients

The user can select any of the clients supported by airtrace as the interface for the infrastructure the are creating. The list of supported clients is detailed in the Clients page.

Currently Airtrace supports either "restful" or "mqtt" as the interface.

Infrastructure Generation

While the Identity creation, assignment, and the creation of the infrastructure for any Deployment is automatically managed in the airtrace website, the user can choose to manually generate a new infrastructure for any Deployment after all of the sensors in that deployment have identities assigned to them.

The user can generate a new infrastructure for a Deployment by calling the following endpoint:

Creates a new infrastructure for a Deployment

POST ​/projects​/{id}​/deployments​/{id_deployment}​/infrastructure​/{interface}

Path Parameters

Name
Type
Description

*

String

The id of the project containing the Deployment

id_deployment*

String

The id of the Deployment for which the user wants to create a new infrastructure

interface*

String

One of the Airtrace supported Clients

The user can generate a new infrastructure for a Plain Project by calling the following endpoint:

Creates a new infrastructure for a Plain Project

POST ​/plain​/{id}​/infrastructure​/{interface}

Path Parameters

Name
Type
Description

*

String

The id of the Plain Project for which the user wants to create a new infrastructure

interface*

String

One of the Airtrace supported Clients

After a new infrastructure is generated, the user's sensors can upload data to the blockchain using the newly created links, for more information on links see sending data from your sensors.

Last updated