Dokumentacija

AlertGuard ESP32 API

Minimalna dokumentacija za priklop prve ESP32 IoT naprave na `/api/iot/ingest`.

Endpoint

POST https://www.alertguard.si/api/iot/ingest

Avtentikacija senzorja

device_key v JSON body

`device_key` se prikaže samo enkrat ob dodajanju senzorja na `/senzorji` in se v bazi shrani samo kot SHA-256 hash.

Pogoste napake

400 JSON payload manjka ali tip meritve ni podprt.
401 Manjka `device_key`, ključ ni pravilen ali `device_id` se ne ujema.
500 Supabase ali tabela ni pravilno pripravljena.

JSON primer za ESP32

{
  "device_key": "ag_iot_...",
  "device_id": "uuid-iz-alertguard",
  "type": "water",
  "value": 1,
  "raw": 2870,
  "battery": null,
  "rssi": -62,
  "status": "online"
}

Primer odziva

{
  "ok": true,
  "device_id": "uuid-iz-alertguard",
  "alarm_created": true,
  "event": {
    "event_type": "iot_water_alarm"
  }
}

Test z ESP32

V AlertGuard odprite `/senzorji`.
Dodajte senzor in kopirajte `device_key`.
V ESP32 kodo vpišite `DEVICE_ID` in `DEVICE_KEY`.
Pošljite prvo meritev z `type=water` in `value=0`.
Za test alarma pošljite `type=water` in `value=1`.