エラーレスポンス

Hotspot API の結果は、認証の失敗（HTTP 401）と成功レスポンス（HTTP 200）の2種類です。ゲスト一覧が空であることはエラーではありません。以下に、発生しうる状況とそれぞれの対処を示します。

HTTP ステータスコード#

コードボディ意味と対処
200{"success": 1, "otelde": [...]}成功。一覧を処理してください。
200{"success": 1, "otelde": []}成功。滞在中のゲストはいません。下記の「空のリスト」の注意事項を参照してください。
401{"success": 0}ApiKey ヘッダーがないか、キーが認識されません。リトライせずにキーを確認し、管理者に通知してください。
404エラーページパスが誤っています。パスが /public/json/customer/inhotel と完全に一致しているか確認してください。
405エラーページPOST 以外のメソッドが使用されました（例：ブラウザーからの GET）。
5xx / タイムアウト—一時的なサーバーエラーまたはネットワークエラーです。間隔を延ばしながら（30秒、1分、5分）リトライし、その間は最後に成功した一覧を使い続けてください。

空のリスト#

otelde: [] は、チェックイン済みの滞在中ゲストがいないことを意味します。閑散期の小規模ホテルでは普通のことです。ただし、前回の照会では多数のゲストがいたのに急に空になった場合は、通常ホテル側の操作ミス（誤った一括チェックアウト、予約ステータスの変更）が原因です。すべての Wi-Fi アカウントを停止する前に、2回続けて空の一覧が返ることを確認してください。

リトライとタイムアウト#

  • リクエストのタイムアウトは10秒にしてください。大規模なホテルでも、一覧はその時間内に返ります。
  • 5xx とネットワークエラーはリトライしてください。401、404、405 は設定の誤りなのでリトライしないでください。
  • 照会が失敗している間は、最後に成功した一覧を保持してください。アカウントを停止するのは、成功したレスポンスで一覧から外れたゲストだけにしてください。
  • 連続した失敗の回数を記録し、しきい値（例：15分）を超えたら管理者に通知してください。

よくあるケース#

状況考えられる原因対処
ゲストが一覧にないフロントでチェックインが済んでいない、予約がキャンセルされた、ゲストに「滞在中」のフラグが付いていない、またはチェックアウト済み。ポータルに「部屋番号と姓が一致しません」と表示し、フロントへの問い合わせを案内してください。再取得は不要で、次回の同期でゲストが表示されます。
同じ部屋に複数のレコードがある複数のゲストがその部屋に滞在しており、それぞれが個別のレコードになっている。正常な動作です。ゲストごと（unique）にアカウントを有効にしてください。
identityNumber が空ゲストが身分証情報なしで登録された。照合には姓 + 生年月日を代わりに使用してください。トルコ法第5651号の記録ではこのフィールドを空のままにし、unique に紐づけてください。
roomName が一致しないゲストが「104」ではなく「0104」や「Room 104」と入力した。値は文字列です。比較する前に両方の値を正規化してください。数値には変換しないでください。
checkout が過去なのにゲストが一覧にあるゲストが滞在を延長したか、レイトチェックアウト中で、フロントがまだ処理していない。ゲストが一覧にある間はアクセスを維持してください。checkout が変わったらセッションの終了時刻を更新してください。
最終更新: 2026年9月21日誤りを見つけましたか？お知らせください