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

Add entrance observer metrics

POST
/entrance/v1/movement
Stores specified simple colony (specified by hive_id) metrics. Uses current time.
Reports bees movement coming in and out of the hive
We assume you call this endpoint periodically (every 30sec) and thus values present are collected within this interval.

Request

Query Params

Body Params application/json

Example
{
    "hiveId": 0,
    "boxId": 0,
    "detectedBees": 0,
    "stationaryBees": 0,
    "beeInteractions": 0,
    "beesIn": 0,
    "beesOut": 0,
    "netFlow": 0,
    "avgSpeed": 0,
    "p95Speed": 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 -g --request POST '/entrance/v1/movement?api_token={{api_token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "hiveId": 0,
    "boxId": 0,
    "detectedBees": 0,
    "stationaryBees": 0,
    "beeInteractions": 0,
    "beesIn": 0,
    "beesOut": 0,
    "netFlow": 0,
    "avgSpeed": 0,
    "p95Speed": 0
}'

Responses

🟢201OK
text/plain
Body

Example
OK
Modified at 2025-09-07 22:26:52
Previous
Add hive IoT metrics
Built with