Přeskočit na hlavní obsah

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

Chcete-li doručovat zprávy 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.