Réponses d’erreur
L’API Hotspot produit deux types de résultat : un échec d’authentification (HTTP 401) et une réponse réussie (HTTP 200). Une liste de clients vide n’est pas une erreur. Vous trouverez ci-dessous les situations que vous pouvez rencontrer et la marche à suivre dans chaque cas.
Codes de statut HTTP#
| Code | Corps | Signification et marche à suivre |
|---|---|---|
200 | {"success": 1, "otelde": [...]} | Succès. Traitez la liste. |
200 | {"success": 1, "otelde": []} | Succès ; aucun client n’est en séjour. Voir la remarque sur les listes vides ci-dessous. |
401 | {"success": 0} | En-tête ApiKey absent ou clé non reconnue. Ne réessayez pas ; vérifiez la clé et alertez l’administrateur. |
404 | Page d’erreur | Chemin incorrect. Vérifiez que le chemin est exactement /public/json/customer/inhotel. |
405 | Page d’erreur | Une méthode autre que POST a été utilisée (p. ex. GET depuis un navigateur). |
5xx / délai dépassé | — | Erreur temporaire du serveur ou du réseau. Réessayez avec des délais croissants (30 s, 1 min, 5 min) et continuez entre-temps à utiliser la dernière liste obtenue avec succès. |
Liste vide#
otelde: [] signifie qu’aucun client enregistré n’est en séjour, ce qui est normal pour un petit hôtel hors saison. En revanche, une liste pleine lors de la requête précédente et soudain vide révèle généralement une erreur de manipulation côté hôtel (check-out groupé par erreur, changement de statut d’une réservation). Avant de fermer tous les comptes Wi-Fi, vérifiez que la liste est revenue vide lors de deux requêtes consécutives.
Nouvelles tentatives et délais d’attente#
- Utilisez un délai d’attente de 10 secondes par requête ; même pour les grands hôtels, la liste est renvoyée dans ce délai.
- Réessayez en cas de
5xxet d’erreur réseau ; ne réessayez pas en cas de401,404ou405, qui sont des erreurs de configuration. - Conservez la dernière liste obtenue avec succès tant qu’une requête échoue. Ne fermez que les comptes des clients qui ont disparu de la liste dans une réponse réussie.
- Comptez les échecs consécutifs et prévenez l’administrateur au-delà d’un seuil (p. ex. 15 minutes).
Situations courantes#
| Situation | Cause probable | Que faire |
|---|---|---|
| Client absent de la liste | La réception n’a pas effectué le check-in du client, la réservation a été annulée, le client n’est pas marqué « en séjour » ou a déjà fait son check-out. | Affichez sur le portail « le numéro de chambre et le nom ne correspondent pas » et orientez le client vers la réception. Inutile de relancer la requête : le client apparaîtra à la prochaine synchronisation. |
| Plusieurs enregistrements pour la même chambre | Plusieurs clients séjournent dans la chambre ; chacun constitue un enregistrement distinct. | C’est normal. Ouvrez un compte par client (unique). |
identityNumber vide | Le client a été enregistré sans pièce d’identité. | Pour la correspondance, rabattez-vous sur nom de famille + date de naissance ; laissez le champ vide dans l’enregistrement prévu par la loi turque n° 5651 et rattachez celui-ci à unique. |
roomName ne correspond pas | Le client a saisi « 0104 » ou « Chambre 104 » au lieu de « 104 » ; la valeur est une chaîne. | Normalisez les deux valeurs avant la comparaison ; ne les convertissez pas en nombre. |
checkout dépassé mais client toujours listé | Le client a prolongé son séjour ou part en retard, et la réception ne l’a pas encore enregistré. | Laissez l’accès ouvert tant que le client figure dans la liste ; mettez à jour la fin de session lorsque checkout change. |