Gratheon
  1. IoT sensors as client v1
Gratheon
  • 🐶 Walk through Apidog
  • Telemetry REST API
    • IoT sensors as client v1
      • Add hive internal temperature set
        POST
      • Add hive IoT metrics
        POST
    • Entrance observer as client v1
      • Add entrance observer metrics
  1. IoT sensors as client v1

Add hive internal temperature set

Developing
POST
/iot/v1/temperature
Stores beehive (hive_id) internal temperatures (temperatureSet)
Because hive is a complex structure, you can report temperature to reflect it in 3d.
This can help beekeeper to understand if there are any wind/drafts, how do bees warm up the space.
Position your temperature sensor in any hive section (sectionNr).
We start numbers from the bottom (0), same as in web-app.
By default we will consider that you have placed your sensor on the last hive section (-1) in the middle (x,y = 0.5) of the section, on top of the frames (z=1)

Request

None

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/iot/v1/temperature'

Responses

🟢200Success
application/json
Body
hiveId
integer 
required
temperatureSet
array [object {3}] 
required
valueCelsius
string 
required
Float value of temperature in Celsius degrees
sectionNr
string 
required
Hive section number. We start numbers from the bottom (0). Default -1. If value is "-1", we will consider this as a last hive section (top).
position
object 
required
Example
{
    "hiveId": 0,
    "temperatureSet": [
        {
            "valueCelsius": "string",
            "sectionNr": "string",
            "position": {
                "z": "string",
                "y": "string",
                "x": "string"
            }
        }
    ]
}
Previous
🐶 Walk through Apidog
Next
Add hive IoT metrics
Built with