🔗 API

Lets setup your devices to interact with Gratheon!

You can also see how exactly we process this data - check out our architecture, services, code, reasons to choose one solution over another. If you are technical enough and find this useful, feel free to improve these guides in github or even add new ones.

Quickstart

To access our API, you will need to generate API token in user profile. Tokens allow us to authenticate you and have ratelimiting. You must pass this token in Authorization http header and have Bearer as prefix, for example:

curl --location 'https://graphql.gratheon.com/graphql' \
--header 'Content-Type: application/json' \
--data '{"query":"{ apiaries { id name } }"}' \
--header 'Authorization: Bearer API_TOKEN_HERE'

REST APIs

IoT sensors can use this API to send temperature, weight and other timeseries data.

curl --location 'https://telemetry.gratheon.com/metric?api_token=API_TOKEN' \
--data '{
"hive_id": 123,
"fields":{ "temperature":31.25, "weight": 82.34 }
}'