L'interface communique avec un Serveur Amadeus HotSOS via l'API REST.
L'interface synchronise uniquement les données de la pièce et non les événements. Si cela est nécessaire, veuillez contacter le support d'Antcas.
Remarque: L'interface est très lente lors de l'envoi. Il peut falloir un moment avant que la valeur n'apparaisse dans le moniteur.
Des requêtes individuelles sont effectuées par le serveur Antcas via HTTPS sur le portail HotSOS. L'URL de l'API est fixée et ne peut pas être modifiée. Les pièces, définies précédemment dans l'application HotSOS et dans la configuration d'Antcas, sont interrogées. La limite de requêtes est de 30 requêtes par minute par défaut. Le serveur Antcas respecte strictement cette politique pour réduire la charge du côté opposé et du réseau. Cela signifie qu'il peut falloir quelques minutes avant qu'un changement soit pris en compte par le serveur Antcas.
Lors du démarrage du serveur, les messages sont toujours récupérés en premier, puis tous les rapports d'état sont transmis. Si un changement intervient entre-temps du côté de HotSOS, cela a pour conséquence que l'état arrive d'abord dans la PLC et est ensuite renvoyé.
En cas d'erreur de connexion, la requête est automatiquement répétée après l'expiration du délai d'attente. Le message d'erreur n'apparaît qu'une seule fois dans le moniteur. Si aucune connexion n'est établie dans le délai d'attente de connexion défini, l'interface est également déclarée hors ligne.
L'adresse de destination est l'adresse du serveur sans URI et préfixe https://.
Remarque: Lors de l'utilisation d'un serveur proxy, il faut veiller à ce que le chemin URI ne change pas.
Le moniteur peut afficher diverses sources. Dans le tableau suivant, toutes les possibilités sont expliquées.
| Source | Description |
|---|---|
| Client | Valeur provenant de l'entité HotSOS. |
| Serveur | Valeur envoyée ou lue par Antcas Control. |
| Système | Message système général. |
| Nom | Type de données | Description |
|---|---|---|
| chaîne de caractères | Définir le numéro de la pièce conformément à l'interface. | |
| booléen | Demander le nettoyage de la chambre. | |
| chaîne de caractères | Statut de service actuel de la pièce. | |
| chaîne de caractères | Statut de la pièce. | |
| chaîne de caractères | Nom de la pièce reçu. | |
| booléen | Ne pas déranger reçu. | |
| booléen | La pièce est occupée. |
Remarque: Seuls les valeurs suivantes peuvent être envoyées. Toutes les autres valeurs ne sont pas envoyées et sont marquées en rouge dans le moniteur.
| Valeur | Description |
|---|---|
| CLEAN | La pièce est propre. |
| DIRTY | La pièce est sale. |
| OUT_OF_ORDER | La pièce est endommagée. |
| OUT_OF_SERVICE | La pièce est hors service. |
| INSPECTED | La pièce a été inspectée. |
| PICKUP | La pièce se trouve dans l'état de récupération. |
Remarque: Seules les valeurs AWAITING_SERVICE et DO_NOT_DISTURB peuvent être envoyées.
| Valeur | Description |
|---|---|
| AWAITING_SERVICE | La pièce attend le nettoyage. |
| DO_NOT_DISTURB | L'invité ne veut pas être dérangé. |
| VACANT_CLEANED | La pièce a été nettoyée et est libre. |
| OCCUPIED_CLEANED | La pièce est nettoyée et occupée. |
| CLEANING_STARTED | Le nettoyage de la pièce a commencé. |
| SERVICE_REFUSED | L'invité a refusé le service. |
| STOPPED | Le nettoyage a été arrêté. |
| TO_BE_INSPECTED | La pièce nécessite une inspection. |
| INSPECTED | La pièce a été inspectée. |
| LATE_SERVICE | L'invité souhaite un service tardif. |
| RETURN_LATER | L'invité a demandé de revenir plus tard. |