Examples

Latest reading from every device

List all devices in a space and print each one's most recent data message.

cURL

API_KEY="<api-key>"
SPACE="<space-id>"
BASE="https://api.hardwario.cloud/v2"

curl -s -H "X-API-KEY: $API_KEY" "$BASE/spaces/$SPACE/devices?limit=500" \
| jq -r '.[].id' \
| while read -r DEV; do
    echo "== $DEV =="
    curl -s -H "X-API-KEY: $API_KEY" \
      "$BASE/spaces/$SPACE/messages?device_id=$DEV&type[]=data&limit=1"
    echo
  done

Python

import requests

API_KEY = '<api-key>'
SPACE = '<space-id>'
BASE = 'https://api.hardwario.cloud/v2'
H = {'X-API-KEY': API_KEY}

devices = requests.get(f'{BASE}/spaces/{SPACE}/devices?limit=500', headers=H).json()

for d in devices:
    msgs = requests.get(
        f'{BASE}/spaces/{SPACE}/messages',
        params={'device_id': d['id'], 'type[]': 'data', 'limit': 1},
        headers=H,
    ).json()
    latest = msgs[0]['body'] if msgs else 'no data'
    print(f"{d['name']}: {latest}")

Node.js

const API_KEY = '<api-key>';
const SPACE = '<space-id>';
const BASE = 'https://api.hardwario.cloud/v2';
const H = { 'X-API-KEY': API_KEY };

const devices = await (
  await fetch(`${BASE}/spaces/${SPACE}/devices?limit=500`, { headers: H })
).json();

for (const d of devices) {
  const msgs = await (
    await fetch(`${BASE}/spaces/${SPACE}/messages?device_id=${d.id}&type[]=data&limit=1`, { headers: H })
  ).json();
  console.log(`${d.name}: ${msgs[0]?.body ?? 'no data'}`);
}

Full Reference

The Swagger documentation lists every endpoint (spaces, devices, messages, connectors, tags, variables, firmware, users, keys …) with request and response schemas.