Amadeus HotSOS
인터페이스는 REST-API를 통해 Amadeus HotSOS 서버와 통신합니다.
작동 방식
인터페이스는 방 데이터를만 동기화하며, 이벤트는 동기화하지 않습니다. 필요시 Antcas 지원팀에 문의하세요.
참고: 인터페이스가 전송할 때 매우 느립니다. 모니터에 값이 표시되기까지 시간이 걸릴 수 있습니다.
Antcas 서버에서 HTTPS를 통해 HotSOS 포털로 개별 Polls가 수행됩니다. API URL은 고정되어 있으며 변경할 수 없습니다. HotSOS 애플리케이션과 Antcas Config에서 미리 정의된 방이 조회됩니다. 기본적으로 Poll 제한은 분당 30개의 쿼리로 설정됩니다. Antcas 서버는 설정된 정책을 엄격히 준수하여 상대방의 부하와 네트워크 사용량을 줄입니다. 이는 Antcas 서버에 변경 사항이 반영되기까지 몇 분이 걸릴 수 있음을 의미합니다.
서버를 시작할 때 항상 먼저 메시지가 가져오고, 그 후 모든 상태 메시지가 전송됩니다. HotSOS 측에서 중간에 변경 사항이 발생하면 상태가 먼저 SPS에 도착한 후 다시 전송됩니다.
연결 오류가 발생하면 타임아웃 도달 후 자동으로 쿼리가 반복됩니다. 오류 메시지는 모니터에 한 번만 표시됩니다. 연결 타임아웃 내에 연결이 이루어지지 않으면 인터페이스가 오프라인으로 선언됩니다.
구성
대상 주소는 URI와 https:// 접두사가 없는 서버의 주소입니다.
참고: 프록시 서버를 사용할 경우 URI 경로가 변경되지 않도록 주의하세요.
모니터
모니터는 다양한 소스를 표시할 수 있습니다. 다음 표에서 모든 옵션을 설명합니다.
| 소스 | 설명 |
|---|---|
| 클라이언트 | HotSOS 상대측에서 온 값입니다. |
| 서버 | Antcas Control에서 전송하거나 읽은 값입니다. |
| 시스템 | 일반 시스템 메시지입니다. |
변수
| 이름 | 데이터 유형 | 설명 |
|---|---|---|
| string | 인터페이스에 따라 방 번호를 설정합니다. | |
| bool | 방 청소 요청. | |
| string | 방의 현재 서비스 상태. | |
| string | 방의 상태. | |
| string | 수신된 방 이름. | |
| bool | Do Not Disturb 수신. | |
| bool | 방이 사용 중입니다. |
참고: 다음 값만 전송할 수 있습니다. 다른 모든 값은 전송되지 않으며 모니터에 빨간색으로 표시됩니다.
status
| 값 | 설명 |
|---|---|
| CLEAN | 방이 깨끗합니다. |
| DIRTY | 방이 더럽습니다. |
| OUT_OF_ORDER | 방이 손상되었습니다. |
| OUT_OF_SERVICE | 방이 사용 중지되었습니다. |
| INSPECTED | 방이 검사되었습니다. |
| PICKUP | 방이 수거 상태에 있습니다. |
service_status
참고: AWAITING_SERVICE 및 DO_NOT_DISTURB 값만 전송할 수 있습니다.
| 값 | 설명 |
|---|---|
| AWAITING_SERVICE | 방이 청소를 기다리고 있습니다. |
| DO_NOT_DISTURB | 손님이 방해받지 않기를 원합니다. |
| VACANT_CLEANED | 방이 청소되고 비어 있습니다. |
| OCCUPIED_CLEANED | 방이 청소되고 사용 중입니다. |
| CLEANING_STARTED | 방의 청소가 시작되었습니다. |
| SERVICE_REFUSED | 손님이 서비스를 거부했습니다. |
| STOPPED | 청소가 중지되었습니다. |
| TO_BE_INSPECTED | 방이 검사가 필요합니다. |
| INSPECTED | 방이 검사되었습니다. |
| LATE_SERVICE | 손님이 늦은 서비스를 원합니다. |
| RETURN_LATER | 손님이 나중에 돌아올 것을 요청했습니다. |