Actabl Alice

このインターフェースは、REST-APIを介してActabl Aliceサーバーと通信します。

動作方法

このインターフェースは、イベントではなく部屋のデータのみを送信します。必要な場合は、Antcasサポートにお問い合わせください。

注意: このインターフェースは送信が非常に遅いため、値がモニターに表示されるまで少し時間がかかることがあります。

AntcasサーバーからActablポータルへHTTPSを介して個々のポーリングが行われます。API-URLは固定されており変更できません。この際、事前にActablアプリケーションとAntcas Configで定義された部屋が照会されます。ポーリング制限は標準的に30分あたりの問い合わせです。Antcasサーバーは設定された方針を厳密に守り、相手側とネットワークの負荷を軽減するためです。これは、Antcasサーバーへの変更が数分かかる可能性があることを意味します。

注意: 値を1日1回送信することが推奨されます。このインターフェースは送信のみ可能で値を読み取ることはできません。

接続エラーが発生した場合、タイムアウト到達後に自動的に問い合わせが繰り返されます。エラーメッセージはモニターに1回のみ表示されます。設定された接続タイムアウト内に接続が確立できない場合、インターフェースはオフラインと宣言されます。

構成

ターゲットアドレスは、URIやhttps://プレフィックスを除いたサーバーのアドレスです。

注意: プロキシサーバーを使用する場合、URIパスが変更されないようにしてください。

モニター

モニターはさまざまなソースを表示できます。以下の表にすべての可能性について説明します。

ソース 説明
クライアント Actablの対局から送信された値。
サーバー Antcas Controlから送受信された値。
システム 一般的なシステムメッセージ。

変数

名前 データ型 説明
id string インターフェースに応じて部屋名を設定します。
make_up bool 部屋の掃除を要求します。
dnd bool Do Not Disturbを送信します。