Začínáme s Data Push
Telemetrická data ze zařízení Dronetag můžete získávat i tak, že spojení navážou naše servery a data posílají (push) na ty vaše. Tato spojení spravujete v našem portálu integrací, kde si vše nakonfigurujete sami. Portál vám dává plnou kontrolu nad nastavením integrace — můžete zvolit protokol spojení, například HTTP webhooky, MQTT, TCP nebo UDP, snadno přepínat mezi testovacím a produkčním prostředím a upravovat další nastavení podle potřeby.
Jak získat přístup k portálu integrací
K nastavení integrace Data Push potřebujete přístup k portálu. Ten mají uživatelé s předplatným Pro a obchodní partneři zapojení do našich společných projektů. Pokud o přístup máte zájem, ozvěte se nám.
Portál najdete na adrese https://integrations.dronetag.app.
V přehledném webovém rozhraní integraci nastavíte během několika kroků.
Co lze nastavit?
Náš integrační systém je navržený tak, aby byl co nejflexibilnější. U každé integrace si můžete sami, bez naší pomoci, upravit řadu parametrů:
- Protokol spojení: HTTP webhooky, MQTT, TCP nebo UDP.
- Cílová adresa: Data můžete směrovat na produkční nebo testovací (staging) endpoint svého API — je to na vás.
- Výstupní formát: Kromě našeho standardního formátu JSON podporujeme i různé systémy UTM. Doporučené kombinace najdete na stránce Protokoly a formáty.
- Omezení provozu (throttling): Abyste nepřetížili své servery, můžete za cenu určitého zpoždění omezit počet požadavků.
- Ověřování: Na výběr je řada způsobů ověřování, mimo jiné HTTP Basic Authentication, vlastní HTTP hlavičky, OAuth 2.0 a další.
- … a další
Nastavení prvního cíle distribuce
Abyste mohli začít přenášet data, musíte vytvořit cíl distribuce (distribution target). Ten představuje službu, do které chcete data posílat. Cílů můžete vytvořit několik, jejich počet je ale omezený. Jakmile cíl vytvoříte, náš systém do něj bude data automaticky posílat, dokud ho nedeaktivujete nebo neodstraníte.
- Přihlaste se do portálu integrací svým účtem Dronetag, nebo si vytvořte nový.
- Na hlavní stránce uvidíte všechny distribuce, které jste vytvořili.
- Vytvořte nový cíl distribuce tlačítkem Add New.
- Vyplňte formulář s konfigurací cíle. S nastavením vám pomohou další sekce na této stránce.
- Cíl uložte a počkejte několik minut, než se změny projeví.
- Chyby komunikace nebo konfigurace zkontrolujete v serverových lozích. Najděte novou distribuci na hlavní stránce a klikněte na View & Edit.
Pozastavení nebo ukončení distribuce
Chcete-li dočasně přestat posílat data do svých služeb, distribuci pozastavte tím, že ji označíte jako neaktivní. Pokud distribuci už nepotřebujete, můžete ji trvale smazat.
Co dál?
- Po nastavení integrace zkontrolujte, zda funguje správně.
- Přečtěte si více o našem formátu DUMP JSON.
- Pokud vám tento způsob integrace nevyhovuje, podívejte se na návod k výběru nejvhodnějšího způsobu integrace.