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

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.