Gateway API
API for the Ruuvi Gateway
Gateway API uses a JSON based API to facilitate communication between Ruuvi Gateways and the databases by validating and forwarding the data.
Send sensor data
POST
https://api.placeholder.com/dev/record
Sends a bulk of data to Ruuvi Network to be processed and stored.
Headers
Request Body
Data payload consists of gateway information and an array of tag measurements as illustrated below.
MAC address format: XX:XX:XX:XX:XX:XX (where XX is a hexadecimal digit in upper case). Example: "11:22:33:AA:BB:CC" MAC address is used in "<GATEWAY MAC ADDRESS>" and in "<TAG ID 1>", "<TAG ID 2>", ...
The signature is a HMAC (hash-based message authentication code) which is calculated using sha256 algorithm from a combination of headers and the message body. Ruuvi network validates the signature against the whitelisted gateways (see: Internal API).
Below is an example code for calculating the secret:
Last updated