Gratheon REST API
  1. IoT sensors as client v1
Gratheon REST API
  • Telemetry service
    • IoT sensors as client v1
      • Add hive internal temperature set
        POST
      • Add hive IoT metrics, single measurement
        POST
      • Add hive IoT metrics, multiple measurements
        POST
    • Entrance observer as client v1
      • Add entrance observer metrics
  • Video service
  1. IoT sensors as client v1

Add hive IoT metrics, multiple measurements

POST
/iot/v1/metrics
Stores multiple hive metric set measurements.
Measurements can be from different hives (specified by hiveId) and from different times (specified by timestamp).
If timestamp is not provided, current time will be used

Request

Header Params

Body Params application/json

Example
[
    {
        "hiveId": 0,
        "fields": {
            "weightKg": 0,
            "humidityPercent": 0,
            "temperatureCelsius": 0
        },
        "timestamp": 0
    }
]

Request Code 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": {
            "weightKg": 0,
            "humidityPercent": 0,
            "temperatureCelsius": 0
        },
        "timestamp": 0
    }
]'

Responses

🟢201OK
text/plain
Body

Example
OK
Modified at 2025-11-20 23:42:03
Previous
Add hive IoT metrics, single measurement
Next
Add entrance observer metrics
Built with