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 IoT metrics

POST
/iot/v1/metrics
Stores specified simple hive (specified by hive_id) metrics.
Uses current time.

Request

Header Params
Authorization
string 
optional
Example:
Bearer {api_token}
Body Params application/json
hiveId
integer 
required
fields
object 
required
temperatureCelsius
number 
optional
Internal hive temperature (in celsius, float). This is a simplified way to send temperature. See /metric/temperature for more complex scenarios
weightKg
number 
optional
Hive total weight (in kg, float)
humidityPercent
number 
optional
Internal humidity (percent)
Example
{
    "hiveId": 0,
    "fields": {
        "temperatureCelsius": 0,
        "weightKg": 0,
        "humidityPercent": 0
    }
}

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/metrics' \
--header 'Authorization: Bearer {api_token}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "hiveId": 0,
    "fields": {
        "temperatureCelsius": 0,
        "weightKg": 0,
        "humidityPercent": 0
    }
}'

Responses

🟢201OK
text/plain
Body
string 
optional
Example
OK
Previous
Add hive internal temperature set
Next
Add entrance observer metrics
Built with