Если у вас есть своя система — сайт бронирования, CRM, касса, коворкинг-софт — она может работать с iWiFi напрямую: выдавать гостям коды Wi-Fi, заселять постояльцев, забирать статистику и гасить купоны. Без ручной работы в кабинете.
Что умеет API
Типичный пример: гость оплатил бронь на вашем сайте — система сама запрашивает у нас код Wi-Fi и присылает его гостю в письме. Человек приезжает и уже знает код.
- Заведения и точки — список со статусами;
- Ваучеры — создание и выдача кодов доступа из вашей системы;
- Проживающие — заселение и выселение (для отелей);
- Сессии и статистика — данные о подключениях для ваших отчётов;
- Купоны — гашение по коду прямо из вашей кассы.
Как начать
- Раздел «API» в меню кабинета (доступен владельцу аккаунта) → «Новый ключ».
- Выберите права: чтение и/или запись, при желании ограничьте ключ конкретными заведениями.
- Секрет ключа показывается один раз — скопируйте сразу. Потерялся — выпустите новый.
- Отдайте ключ разработчику вместе со ссылками на документацию ниже.
Документация
Открыта всем, без регистрации:
руководство с примерами ↗ и
справочник всех методов ↗.
Адрес API: https://api.iwifi.ru/v1.
Безопасность
- Ключ — как пароль: держите его на сервере, не вставляйте в сайт или мобильное приложение;
- в карточке ключа можно указать разрешённые IP — с чужого адреса он не сработает, даже если утечёт;
- все обращения видны в журнале раздела, о новых адресах приходит письмо;
- персональные данные гостей API не отдаёт — телефоны и документы приходят под маской: полные данные видны только в кабинете, по коду подтверждения.
При выдаче кода гостя нужно назвать — телефон либо ФИО с документом: этого требует закон (ПП РФ 2606/2607), доступ в интернет не бывает анонимным. Ваша система обычно и так знает гостя — по брони или оплате.
PMS для отелей — заселение без рук
Отдельная интеграция для отелей: ваша система управления (АСУ) сама отправляет заселения и выселения в iWiFi — проживающие появляются в кабинете, гость входит в вайфай по фамилии и номеру комнаты. Настройка: раздел «Проживающие» → «Интеграция с PMS», там ваш персональный адрес вебхука. Работаем с Bnovo и TravelLine — подключим вместе с вами; нужна другая система — напишите, добавим адаптер.
Подробнее о гостиничном режиме — в статье про Wi-Fi в отеле.
Тариф
API доступен на тарифе «Про», PMS-вебхуки — на «Отеле» и выше. Актуальный состав — на странице тарифов. Вопросы разработчика — в «Обращения» кабинета, поможем.
Ещё по теме