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