Skip to main content

CREATING A QUBITRO CONNECTION

Collecting Expected Information

Parameters required

FieldDescription
Project IDGet it when creating a device
Webhook Signing KeyGet it when creating a device

Project ID & Webhook Signing Key

  1. To get the required credentials, choose a project from the list, then, click on the New source button and click on Actility in the list. connectivity_method

  2. You are now able to get those two required fields by clicking on them device_info

Creating a Connection With API

The creation of a connection establishes a unidirectional messaging transport link to the cloud provider.

To do this, you need to use the Connections group resource:

  • POST/connections to create a new Connection instance
  • PUT/connections to update a Connection instance
  • DELETE/connections to delete a Connection instance
Note

We follow the REST-full API pattern, when updating configuration properties for a connection resource. Thus, you must also provide the whole configuration again.

Example for creation of a new connection instance :

POST /connections
{
"name":"Actility to Qubitro",
"connectorId":"actility-http-iot",
"configuration": {
"destinationURL":"https://webhook.qubitro.com/integrations/actility",
"headers": {
"projectId":"aa62ebe1-7ff3-4d05-baec-e6ff2edf34a4",
"webhookSigningKey":"NGtFMlNZdEZpRVpmeXRMNFJpbVM1THVJa3EzMg=="
}
},
"brand":"QUBITRO"
}

The following table lists the properties applicable to a connection instance.

FieldDescription
connectorIdMust be set to actility-http-iot for Tago platform.
configuration/projectIdMust be replaced by your Project ID, found during device creation.
configuration/webhookSigningKeyMust be replaced by your Webhook Signing Key during device creation.
brandMust be set to QUBITRO.
Important note

All properties are not present in this example. You can check the rest of these properties in the common parameters section.

Creating a Connection With UI

  1. Click Connections -> Create -> ThingPark X IoT Flow create

  2. Then, a new page will open. Select the connection type: Qubitro. select

  3. Fill in the form as in the example below and click on Create. (refer to this section to collect fields.) filled_form

Note

Parameters marked with * are mandatory.

  1. A notification appears on the upper right side of your screen to confirm that the application has been created.

  2. After creating the application, you will be redirected to the connection details.

Limitations

Limitations depends on Account Plan you own.

Displaying information to know if it worked

  1. Connect to your Qubitro account.

  2. Click on New project, chose a Name and a Description, and then click Create. new_project

  3. Now click on New source button and select Actility. connectivity_method

  4. You now have access to your Project ID and Webhook Signing Key. Put these informations in Thingpark X Qubitro form. device_info

  5. You'll now be able to see if you received Devices messages. data device_data

Troubleshooting

As for now, there are no detected bugs.