Ingest (gép-kulcsok)

Az eszközök (vagy átjárók) az ingest végponton küldik be a mérési adatokat. A hitelesítés ingest kulccsal történik, amelyet az admin felület Rendszer → Ingest kulcsok oldalán hozol létre — a kulcs a szervezethez kötött, és csak létrehozáskor látható.

Végpont

POST https://ingest.signalguard.hu/v1

A végpont verziózott (/v1): a beküldés formátuma ezen az útvonalon stabil marad; egy későbbi változat új útvonalat kap, a régi tovább működik. A pontos, környezetedhez tartozó címet az admin felület Ingest kulcsok oldala is kiírja, az eszközre kész hívás-mintát pedig az eszköz szerkesztő API hívás nézete generál (curl, HTTPie, Postman, PowerShell, Python, Node).

Beküldés

A kérés x-api-key fejléccel megy, a törzsben a szervezet, az eszköz EUI-ja és a szenzoronkénti értékek (SUI szerint). Kötegelt forma (ajánlott: az eszköz összes szenzora egy hívásban):

curl -X POST https://ingest.signalguard.hu/v1 \
  -H "x-api-key: sgk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "organisation_id": "demo1",
    "eui": "0018B20000000001",
    "value_at": "2026-09-19T10:00:00Z",
    "values": [
      { "sui": "SUI-164892fe", "value": 26.7 },
      { "sui": "SUI-6efee967", "value": -18.2, "value_at": "2026-09-19T09:59:30Z" }
    ]
  }'

organisation_id — kötelező; egyeznie kell a kulcs szervezetével (eltérés esetén 403 org_mismatch).
value_at — opcionális ISO időbélyeg; elhagyva a beérkezés ideje. Elemenként felülbírálható.
Az elemek egymástól függetlenül dolgozódnak fel: egy ismeretlen SUI nem dobja el a többit. A válasz 200, ha legalább egy elem sikerült, 400, ha egy sem:

{ "ok": true, "organisation_id": "demo1", "accepted": 2, "rejected": 0,
  "results": [ { "sui": "SUI-164892fe", "ok": true, "id": 1, "archived_previous": true }, ... ] }

Egy-szenzoros forma (visszafelé kompatibilis):

{ "eui": "0018B20000000001", "sui": "SUI-164892fe", "value": 26.7 }

Válasz: 201 új értéknél, 200 felülírásnál (archived_previous: true), 404 unknown_sensor, 409 inactive_sensor.

Hibák

Státusz	Jelentés
`401` / `403 Forbidden`	hiányzó, ismeretlen vagy visszavont kulcs
`400`	hibás JSON, hiányzó `eui`/`organisation_id`/`values`, nem szám érték
`403 org_mismatch`	a törzs `organisation_id`-ja nem a kulcs szervezete
`429`	túl sok kérés (globális védelem) — később újrapróbálható

Működés

Az érték az eszköz aktuális értékei közé kerül (SUI szerint), a korábbi érték a történetbe; az eszköz utolsó kommunikáció ideje frissül.
A beküldés a kulcshoz tartozó szervezetre érvényes — más szervezet eszközére nem lehet adatot beküldeni.
A kulcs az admin felületen bármikor visszavonható (a beküldés azonnal leáll; a visszavonás végleges), és kulcsonként megtekinthető a használat (napi beküldés-szám az elmúlt két hétre).