Sending Measurements via HTTP API

While the preferred method for sending measurements to BioT is by using the lightweight MQTT protocol, BioT also allows to post measurements via HTTP API.

Using this API you'll be able to send individual measurements or if you have many measurements in high frequency or if you prefer to send messages in bulk, please read more about how to send measurements in waveform.

You can send a single measurement via this API or multiple measurements at once via this API.

To send measurements via API make a post request:
POST https://example.com/measurement/v1/measurements
With the following request body:

{
   "metadata":{
      "timestamp":"2022-07-28T14:02:26.199Z",
      "deviceId":"device1",
      "patientId":"4fc9a489-1d27-46e6-89cc-0a5531076cb5",
      "sessionId":"e73bf586-1c86-4664-9152-86f515fd612e"
   },
   "data":{
      "hr":98,
      "temperature":36.5
   }
}

The data will be saved into the measurements DB.

🚧

Sending live data

Please note that data sent to BioT in this manner cannot be monitored via the patient live observation window. This limitation stems from the fact that only MQTT data is monitored by the observation window.
The historical view is not affected.

🚧

Sending historical measurements

In some cases historical measurements shall be uploaded by the device. Historical measurements are defined as measurements that their timestamp is older than 1 day from the current timestamp This can happen, for example, when the device that was offline for a while, uploads it's locally save measurement to the cloud.

In this case it will take up to 6 hours for the data to be added to the database and be searchable from the historical view.

If you need to send measurements older then a single day that need to be logged in immediately, please contact us and we will update the platform to fit your exact needs.