Actabl Alice

Rajapinta kommunoi Actabl Alice -palvelimen kanssa REST-API:n kautta.

Toimintatapa

Rajapinta välittää vain tilatietoja, ei tapahtumia. Jos tämä on tarpeen, ota yhteyttä Antcasin tukeen.

Huomautus: Rajapinta on hyvin hidas lähettämisessä. Se voi kestää hetken ennen kuin arvo ilmestyy monitoriin.

Antcas-palvelimelta tehdään yksittäisiä pyyntöjä HTTPS:n kautta Actabl-portaaliin. API-URL on kiinteä ja sitä ei voi muuttaa. Tällöin kysytään huoneita, jotka on määritetty aiemmin Actabl-sovelluksessa ja Antcas Configissa. Poll-rajoitus on oletuksena 30 kyselyä minuutissa. Antcas-palvelin noudattaa tiukasti asetettua ohjetta, jotta vastapuolen ja verkon kuormitus vähenee. Tämä tarkoittaa, että voi kestää muutamia minuutteja ennen kuin muutos saapuu Antcas-palvelimelle.

Huomautus: Suositellaan lähettämään joka arvo kerran päivässä. Rajapinta voi vain lähettää ja ei voi lukea arvoja.

Jos yhteysvirhe ilmenee, kysely toistetaan automaattisesti aikakatkaisun saavuttamisen jälkeen. Virheilmoitus näkyy monitorissa vain kerran. Jos yhteyttä ei saada aikaan asetettuna yhteysaikakatkaisuna, rajapinta julistetaan myös offline-tilaksi.

Konfigurointi

Kohdeosoite on palvelimen osoite ilman URI:tä ja https://-etuliitettä.

Huomautus: Proxy-palvelinta käytettäessä on varmistettava, että URI-polku ei muutu.

Monitori

Monitori voi näyttää eri lähteitä. Seuraavassa taulukossa kaikki mahdollisuudet selitetään.

Lähde Kuvaus
Asiakas Actabl-vastapuolelta tuleva arvo.
Palvelin Antcas Controlilta lähetetty tai luettu arvo.
Järjestelmä Yleinen järjestelmäviesti.

Muuttujat

Nimi Tietotyyppi Kuvaus
id string Asettaa huoneen nimen rajapinnan mukaisesti.
make_up bool Pyydä huoneen siivousta.
dnd bool Lähetä Do Not Disturb.