Actabl Alice

Rozhraní komunikuje se serverem Actabl Alice přes REST-API.

Funkční princip

Rozhraní přenáší pouze data místností a neudálosti. Pokud je to nutné, obraťte se na podporu Antcas.

Poznámka: Rozhraní je velmi pomalé při odesílání. Může chvíli trvat, než se hodnota zobrazí v monitoru.

Jednotlivá zjišťování jsou prováděna serverem Antcas přes HTTPS na portál Actabl. URL API je pevně stanoveno a nelze jej změnit. Při tom se dotazují místnosti, které byly dříve definovány v aplikaci Actabl a v konfiguraci Antcas. Limit zjišťování činí standardně 30 dotazů za minutu. Server Antcas přísně dodržuje nastavenou politiku, aby snížil zatížení druhé strany a sítě. To znamená, že může trvat několik minut, než se změna dostane na server Antcas.

Poznámka: Doporučuje se přenášet každou hodnotu jednou denně. Rozhraní může pouze odesílat a nelze z něj číst hodnoty.

Pokud dojde k chybě spojení, opakuje se dotaz automaticky po uplynutí timeoutu. Chybová zpráva se zobrazí v monitoru pouze jednou. Pokud nedojde ke spojení během nastaveného časového limitu spojení, je rovněž rozhraní označeno jako offline.

Konfigurace

Cílová adresa je adresa serveru bez URI a https://-prefixu.

Poznámka: Při použití proxy serveru je třeba dbát na to, aby se nezměnil URI cestový řetězec.

Monitor

Monitor může zobrazovat různé zdroje. V následující tabulce jsou vysvětleny všechny možnosti.

Zdroj	Popis
Klient	Hodnota přijatá od protistrany Actabl.
Server	Hodnota odeslaná nebo přečtená Antcas Control.
Systém	Obecná systémová zpráva.

Proměnné

Jméno	Datový typ	Popis
id	string	Nastavuje název místnosti podle rozhraní.
make_up	bool	Žádost o úklid místnosti.
dnd	bool	Odeslat Do Not Disturb.