HARDWARIO Cloud REST API
HARDWARIO Cloud v2 nabízí kompletní REST API pro vše, co umíte ve webovém rozhraní — čtení zařízení a zpráv, správu tagů a proměnných, odesílání downlinků a další.
- Základní URL:
https://api.hardwario.cloud/v2 - Interaktivní reference: Dokumentace API Swagger — kompletní, vždy aktuální seznam endpointů a schémat.
- Formát: JSON. Posílejte
Accept: application/json; ID jsou UUID.
Pro živá data preferujte konektory
Pro doručování zpráv ze zařízení v reálném čase použijte konektory (HTTPS webhooky) místo dotazování REST API. Dotazování zvyšuje zpoždění doručení, datový provoz i zátěž služby — webhook vám každou zprávu odešle v okamžiku, kdy dorazí.
Návody
- Autentizace — vytvoření API klíče a autentizace požadavků.
- Čtení dat — výpis prostorů, zařízení a zpráv; filtrování a stránkování.
- Správa zařízení — zprovoznění, aktualizace a odebrání zařízení.
- Tagy — vytváření tagů a jejich přiřazování k zařízením.
- Proměnné — metadata typu klíč–hodnota pro jednotlivá zařízení.
- Odesílání downlinků — odeslání konfiguračních, shellových a datových příkazů do zařízení.
- Příklady — kompletní ukázky v cURL, Pythonu a Node.js.