Přeskočit na hlavní obsah

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.