Actabl Alice

Interfejs komunikuje się z serwerem Actabl Alice za pośrednictwem API REST.

Działanie

Interfejs przekazuje tylko dane pomieszczeń, a nie zdarzenia. Jeśli jest to konieczne, skontaktuj się z supportem Antcas.

Uwaga: Interfejs jest bardzo wolny przy wysyłaniu. Może upłynąć chwilę, zanim wartość pojawi się w monitorze.

Pobierane są pojedyncze polli od serwera Antcas za pośrednictwem HTTPS do portalu Actabl. Adres URL API jest ustalony na stałe i nie może być zmieniony. W ten sposób zapytane są pomieszczenia, które wcześniej zostały zdefiniowane w aplikacji Actabl i w konfiguracji Antcas. Limit polli wynosi domyślnie 30 zapytania na minutę. Serwer Antcas ściśle przestrzega ustalonej polityki, aby zmniejszyć obciążenie drugiej strony i sieci. Oznacza to, że może upłynąć kilka minut, zanim zmiana zostanie odebrana przez serwer Antcas.

Uwaga: Zaleca się przekazywanie każdej wartości raz na dobę. Interfejs może tylko wysyłać i nie może odczytywać wartości.

Jeśli wystąpi błąd połączenia, zapytanie zostaje automatycznie powtórzone po osiągnięciu limitu czasu oczekiwania. Komunikat o błędzie pojawia się tylko raz w monitorze. Jeśli nie nastąpi połączenie w ciągu ustalonego limitu czasu oczekiwania na połączenie, interfejs zostanie oznaczony jako offline.

Konfiguracja

Adres docelowy to adres serwera bez URI i prefiksu https://.

Uwaga: Przy użyciu serwera proxy należy upewnić się, że ścieżka URI nie zmienia się.

Monitor

Monitor może wyświetlać różne źródła. W poniższej tabeli opisano wszystkie możliwości.

Źródło	Opis
Klient	Wartość pochodząca od strony Actabl.
Serwer	Wartość wysłana lub odczytana przez Antcas Control.
System	Ogólna wiadomość systemowa.

Zmienne

Nazwa	Typ danych	Opis
id	string	Ustawia nazwę pomieszczenia zgodnie z interfejsem.
make_up	bool	Żądanie sprzątania pokoju.
dnd	bool	Wyślij Do Not Disturb.