Разделы и статьи

API интеграции систем авторизации WiFi для Shelter CLOUD

Назначение API

API предназначено для проверки прав гостя отеля на доступ к WiFi путем сверки предоставленных данных с информацией в системе управления отелем (PMS).

Типовой сценарий

  1. Гость пытается подключиться к Wi-Fi.

  2. Система авторизации перенаправляет его на портал, где запрашивает номер комнаты и дату рождения.

  3. Эти данные отправляются в PMS через API.

  4. Если гость с указанными данными находится в отеле, 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"     } }