Before body

Home
Sensolus platform
Learn how the platform can deliver business insights and how you can configure it
API Integration
All explanation on how to integrate with the Sensolus platform.
Push API
Explanation on the management and usage of the Push API

Getting started
Get started with the Sensolus solution
Sensolus platform
Learn how the platform can deliver business insights and how you can configure it
- Platform navigation
- Asset management
  Learn how to manage and customize your assets.
- Infrastructure management
  Learn how to manage and customize your infrastructure (for example, geobeacons or BLE zone anchors).
- Localization
  Learn how the locations of your assets are captured.
- Information on network operator used by device
  Explanation on where to find information on the network operator your device is currently using.
- Utilization
  Learn how the utilization of your asset fleet can be monitored.
- Geozones
  Learn how to optimize process flows by getting more out of the location information of your assets by using geozones.
- Flows
  Learn how to monitor the rotations of flows of your assets through the supply chain.
- Maintenance
  Learn how to keep your asset fleet maintained in a timely and optimally way.
- Environmental sensing
  Learn how to follow up the conditions of your assets beyond location and activity.
- Dashboards
  Here you can learn about the different types of dashboard on the Sensolus platform.
- Alerts and reports
  Learn how to be notified in case of anomalies in your business processes and how to extract reports with relevant data.
- Customization
  Learn about the different ways to customize the Sensolus platform to your personal preferences.
- User management
  Learn how to manage users, permissions and security.
- Partner account features
  Learn about platform features only available to Sensolus partner accounts aimed at efficiently serving your customers and managing multiple organizations.
- API Integration
  All explanation on how to integrate with the Sensolus platform.
  - Integration principles
    The integration API provides an easy way to interact in 3 different ways with the platform: perform management tasks, retrieve data from the platform with a pull or push mechanism and inject third party data into the platform
  - Pull API
  - Push API
    Explanation on the management and usage of the Push API
    - Management of web hooks
      explanation on the management of webhooks
  - REST API (pdf)
    Description of the key principles of the integration API with the Sensolus platform, with some examples
- 3rd party integrations
  Integrations with devices or platforms and the Sensolus platform.
- General information on the platform
  Everything that is not specifically related to a service but tells you something about the general characteristics of the Sensolus platform and solution
Sensolus Mobile app
Information on the Sensolus mobile app.
Devices
Information on all Sensolus hardware devices
Release notes
Stay up to date with the new and updated features and devices and read the latest updates on our services.
Glossary
Learn to know the most important terms and keywords used on the platform

Push API

Explanation on the management and usage of the Push API

Endpoints

If your requirement is to receive realtime data as soon as it arrives on the Sensolus platform, you can make use of the push API. The push API requires you to set up your own server that will function as an end point for REST calls generated on the platform.

The push API is based on making calls from the Sensolus platform to the integrating party. This requires you to set up a server to receive the incoming calls as REST or MQTT. In the platform, these calls are known as webhooks. The following figure shows the difference between the pull and push API:

We support 2 protocols for pushing data to external servers:

HTTP endpoint: the platform performs a standard REST call. You can configure the URL with optional placeholders and extra header fields. For servers that require a specific format, the json body can be customized with a script.
MQTT endpoint: MQTT is a lightweight protocol that is optimized for networks with small bandwidth and high latency. It supports simple publish/subscribe semantics and is specifically designed with IoT devices in mind. It is an ideal solution for integration of the Sensolus platform with existing IoT architectures where the platform can act as a hub that reliably captures the data, adds the device metadata and publishes them to specific topics based on certain parameters like device tags.