Posílání dat z vlastního systému (API)

Kromě zařízení, která posílají data sama, můžete do svých jednotek posílat naměřené hodnoty z vlastního nebo cizího systému (brána, PLC, skript, jiný cloud) přes jednoduché HTTP API.

1. Vytvořte si API klíč

V pravém menu (pod názvem organizace) → 🔌 Integrace (API klíče). Klepněte na Vytvořit klíč, pojmenujte ho (např. „Brána v kotelně") a potvrďte.

Klíč se zobrazí jen jednou

Hned po vytvoření klíč zkopírujte a bezpečně uložte — z bezpečnostních důvodů ho už nikdy znovu nezobrazíme (v systému je jen jeho otisk). Když ho ztratíte, klíč zneplatníte a vytvoříte nový.

Klíč vypadá takto: tlm_live_ab12cd34_9f8e…. Spravovat klíče (vytvářet, zneplatňovat) může vlastník nebo správce organizace.

2. Pošlete data

Na koncový bod ingestu pošlete POST s hlavičkou Authorization: Bearer <váš klíč>:

curl -X POST https://cloud.telemetrie.online/api/v1/ingest/VAŠE-ZARIZENI \
  -H "Authorization: Bearer tlm_live_ab12cd34_9f8e…" \
  -H "Content-Type: application/json" \
  -d '{"values": {"level_cm": 311.2, "battery_pct": 90}}'

VAŠE-ZARIZENI je sériové číslo (UID) zařízení z vaší organizace.
values je mapa veličina → hodnota; názvy veličin musí odpovídat typu zařízení (stejné jako v grafech a parametrech).
ts (volitelné) je čas měření v ISO formátu ("2026-07-07T10:00:00Z") nebo unixové sekundy. Když ho neuvedete, použije se čas přijetí.
Více měření najednou pošlete jako pole: [{"values": {…}}, {"values": {…}}] (max 500 na požadavek).

Úspěch vrátí 202 a {"accepted": 1}. Data se do několika sekund objeví v grafech, spustí případné alarmy a zapíšou se do historie stejně jako data ze zařízení.

Chybové odpovědi

Kód	Význam
`401`	neplatný nebo chybějící klíč
`403`	zařízení nepatří do organizace vašeho klíče
`404`	zařízení s tímto UID neexistuje
`409`	zařízení není aktivní (musí být přidané/aktivní)
`422`	neplatný obsah (chybné hodnoty nebo názvy veličin)
`429`	příliš mnoho požadavků — chvíli počkejte (viz `Retry-After`)

Bezpečnost

Klíč je organizační — nezaniká, když z organizace odejde konkrétní člověk. Používejte oddělené klíče pro různé systémy, ať je můžete samostatně zneplatnit.
Posílejte výhradně přes HTTPS. Klíč nikdy nedávejte do veřejného kódu.
Klíč můžete kdykoli zneplatnit na stránce Integrace; u každého klíče vidíte, kdy byl naposledy použit.