September 12, 2023 · 2 min read
Integration Templates
We understand that not every device in the world sends measurements in the exact format that Blockbax expects.
To address this, we support the configuration of inbound connectors that transform incoming messages for ingestion into Blockbax. We support multiple protocols (HTTP, MQTT and CoAP) and multiple payload formats (JSON, CBOR, text and bytes). A script describes how to take the payload and produce measurements in the Blockbax platform.
Building such a script can be challenging depending on the device. It would be a shame if everyone using the same device had to reinvent the wheel. That’s why we are introducing integration templates. An integration template describes the protocol and the payload format and contains the script used to ingest payloads into Blockbax. All you have to do is select the right template and you are ready to go!
You can use the template as-is or you can tweak it by converting it to a custom conversion and making necessary changes.
At the time of writing a handful of templates are available, including a converter for the official SenML format. More templates will be added over time, and not just by us. We’ve open-sourced the repository where integration templates are stored. Everyone can now add new templates or improve existing ones! Check out our Github repository at https://github.com/blockbax/integration-templates/tree/main.
So, if you have a device that you want to connect to Blockbax and you’re familiar with JavaScript, drop us a pull request to include it in the collection. The repository contains some simple examples for inspiration as well. We are looking forward to your contributions!
Happy integrating,
The Blockbax Team