Назначение API
API предназначено для проверки прав гостя отеля на доступ к WiFi путем сверки предоставленных данных с информацией в системе управления отелем (PMS).
Типовой сценарий
-
Гость пытается подключиться к Wi-Fi.
-
Система авторизации перенаправляет его на портал, где запрашивает номер комнаты и дату рождения.
-
Эти данные отправляются в PMS через API.
-
Если гость с указанными данными находится в отеле, API возвращает его профиль, и доступ предоставляется.
Для осуществления подобной проверки система авторизации должна делать запросы на URL следующего вида https://pms.frontdesk24.ru/wifi/check_guest.aspx?hotel_id=1424
Вид запроса:
|
curl -X POST \
'https://pms.frontdesk24.ru/wifi/check_guest.aspx?hotel_id=1424' \ -H 'Content-Type: application/json' \ -H 'cache-control: no-cache' \ -H 'content-type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' \ -F api_key=7aacc405-5fee-4f33-aeb4-f33741511dc5 \ -F 'par={"room_number": "1", "birth_date": "01.01.1991"}' |
Важно: ID отеля (в примере 1424) и токен (в примере 7aacc405-5fee-4f33-aeb4-f33741511dc5) можно получить в техподдержке при подключении отеля.
Пример ответа при успешной проверке:
|
{ "success": false, "message": { "guest_id": "2001250", "hotel_visits": [ { "room_num": "1", "join_date": "01.03.2020", "leave_date": "13.01.2019" } ], "fio": "Иван Иванов Иванович", "birth_date": "01.01.1991", "citizenship": "RU", "phone": "+79151111111", "identity_document_type": "ПАСПОРТ РФ", "identity_document_ser": "1234", "identity_document_num": "12345678", "identity_document_issued_date": "14.06.2017", "identity_document_expire_date": "", "identity_document_issuer": "ОВД №132" } } |