HARDWARIO Cloud REST API
HARDWARIO Cloud v2 nabízí kompletní REST API pro vše, co můžete dělat 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 ve Swaggeru: úplný a vždy aktuální seznam endpointů a schémat.
- Formát: JSON. Posílejte
Accept: application/json; ID jsou UUID.
Pro data v reálném čase použijte konektory
Zprávy ze zařízení v reálném čase doručujte konektory (webhooky HTTPS), ne opakovaným dotazováním REST API. Dotazování zvyšuje zpoždění doručení, datový provoz i zátěž služby, kdežto webhook vám každou zprávu pošle hned, jak dorazí.
Návody
- Autentizace: vytvoření klíče API 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ů: odesílání konfigurace, příkazů shellu a datových příkazů do zařízení.
- Příklady: kompletní ukázky v cURL, Pythonu a Node.js.