Private Networks Services

We have standard endpoints in our backend for a number of networks from our partners. If you have a private/closed network, we can create a custom HTTP endpoint in our backend to which you can route the payloads from the Sensoterra sensors. This is necessary, because the payloads need to be decoded and processed (calibrated) in the Sensoterra backend. To have an HTTP endpoint created, please contact your Sensoterra salesperson or Sensoterra Support via support@sensoterra.com. For creating a custom endpoint, an additional service fee may be charged. 

After this custom endpoint is created and you have configured it on your network (including provisioning the sensors via OTAA), the data will flow into our backend automatically and can be retrieved in near real-time through the Sensoterra iOS and Android apps, the web monitor or our Open API. You can find all necessary information about soil moisture data integration in our Moisture Data Integration Guide.

If for some reason it is not possible or desirable to let your sensor readings go through our backend, we have an alternative solution available through our Portal API.

The Sensoterra Portal API is part of our Network Integration Guide which is used to operate Sensoterra probes on a customers LoRaWAN network or private gateways. 

Sensoterra adds value by calibrating the data per soil type. After provisioning the sensors via OTAA, the payloads from the sensors must be processed by our Application Server via the so-called "Portal API". 

If you choose this option, you, the customer, are responsible for provisioning the probe in your network and calling on the Portal API for the decoding of payloads. The decoder API call is protected by OAuth to prevent misuse.

The workflow will be as follows:

• We ship the probes
• We securely deliver the necessary keys to you, the customer.
• You, the customer, need to register the probe, either via the Sensoterra App, or via the Customer API.
• You, the customer, provisions the probe to your LoRa provider.
• You, the customer, uses the decoder API call for interpreting the LoRaWAN payload.

Note that when you use the decoder call, we still gather all probe measurements. So the app and customer site are still fully usable and contain all data. You have the option to either configure the soil type using the app/Customer API, or in the Portal API call.

You will need an OAuth token. You can use the login credentials that you create(d) in the Sensoterra app. Should you choose to provision to a private network server, please note that the support we can offer will be limited, because private servers are beyond our control.

The following guide describes how to deploy probes and how to process payloads. The intended audience are LoRaWAN providers who need to support Sensoterra probes and can integrate it into their own networks and servers. Overview is here further instructions are found in our Custom LoRaWAN Integration Guide below: