How to integrate freezers' and fridges' sensors with FoodDocs?

FoodDocs API expects each measurement to have the following data fields provided:

1. set the Content-Type of the request to application/JSON
2. status – always “MEASURED”
3. sensor_id – identifier of the sensor which the measurement is sent from (for example “sensor_1”)
4. measurement – the numerical value of the measurement – up to 2 decimal places are stored in the system
5. timestamp – ISO format timestamp in the format “YYYY-MM-DDTHH:MM:SS” of the measurement.

There are two options for sending measurements:

1. making a POST request directly to our API
2. sending the measurements via email

Sending measurements with an API request

A POST request should be made to our API endpoint https://api.fooddocs.com/api/sensors/measurements

The request should include a property named company-token in the request header, which can be generated in FoodDocs system settings.

The name field is just for your convenience to be able to identify which key is used for what, and this is not to be confused with the company-token property used in the HTTP request header.

The payload of the request should include an array of measurements with the fields described above. Here is an example of a payload:

[

    {

        "status":"MEASURED",

        "sensor_id":"sensor_1",

        "measurement":37,

        "timestamp":"2022-04-09T09:31:60.000Z"

    }

]

Sending measurements via email

An email with an attached CSV file should be sent to the food handling place's specific email address. FoodDocs will provide the email address.

The CSV file should be in the following format:

1. starting from column B, the 5th line should have the sensor_id
2. starting from line 7 the lines should include a timestamp of the measurement in column A and measurement values in the corresponding column of the sensor

Something we haven't covered?

Feel free to reach out via Live chat button or email support@fooddocs.com