API — средство интеграции приложений
Генерация ваучера
Если вы используете автоматизированную систему управления отелем (в частности, Fidelio, Opera, 1C, Intellect Style, Logus HMS, Здравница) вы можете настроить её на взаимодействие с нашим сервисом. Например, при заселении гостя в момент, когда вы вносите его персональные данные, вы можете отправить запрос на генерацию ваучера. В запросе вы указываете требуемые параметры, например, скорость доступа и время действия ваучера, и в ответ получаете пару логин/пароль, которые можно распечатать и передать гостю. Также, если пожелаете хранить персональные данные о пользователях в нашей системе, можно передать их с помощью необязательных параметров.
Для того, чтобы сгенерировать ваучер, необходимо отправить GET или POST запрос на наш сервер https://api.wifisystem.ru/api , указав при этом ряд параметров.
В настройках хотспота выберите «Стандартные Ваучеры», чтобы гости могли использовать сгенерированные ваучеры этого типа.
Если вы используете автоматизированную систему управления отелем (в частности, Fidelio, Opera, 1C, Intellect Style, Logus HMS, Здравница) вы можете настроить её на взаимодействие с нашим сервисом. Например, при заселении гостя в момент, когда вы вносите его персональные данные, вы можете отправить запрос на генерацию ваучера. В запросе вы указываете требуемые параметры, например, скорость доступа и время действия ваучера, и в ответ получаете пару логин/пароль, которые можно распечатать и передать гостю. Также, если пожелаете хранить персональные данные о пользователях в нашей системе, можно передать их с помощью необязательных параметров.
Для того, чтобы сгенерировать ваучер, необходимо отправить GET или POST запрос на наш сервер https://api.wifisystem.ru/api , указав при этом ряд параметров.
В настройках хотспота выберите «Стандартные Ваучеры», чтобы гости могли использовать сгенерированные ваучеры этого типа.
Пример GET запроса
https://api.wifisystem.ru/api.xml?act=create_voucher&key=9a9b42a034562a4954a9a30d6b221b
&voucher_type=1&amount=72&speed=3&expire=7&data=Иванов%20Сергей%20Викторович&simultaneous=3
Данный пример генерирует ваучер с типом по времени, суммарным временем на 72 часа, со скоростью доступа 3 мбит/с, который истечет через 7 дней после первой активации.
Ответ вы можете получать в формате текста, json или xml форматов.
https://api.wifisystem.ru/api?параметры…
https://api.wifisystem.ru/api.json?параметры…
https://api.wifisystem.ru/api.xml?параметры…
Ответ содержит в себе статус запроса, и пару логин/пароль для доступа ваших посетителей.
https://api.wifisystem.ru/api.xml?act=create_voucher&key=9a9b42a034562a4954a9a30d6b221b
&voucher_type=1&amount=72&speed=3&expire=7&data=Иванов%20Сергей%20Викторович&simultaneous=3
Данный пример генерирует ваучер с типом по времени, суммарным временем на 72 часа, со скоростью доступа 3 мбит/с, который истечет через 7 дней после первой активации.
Ответ вы можете получать в формате текста, json или xml форматов.
https://api.wifisystem.ru/api?параметры…
https://api.wifisystem.ru/api.json?параметры…
https://api.wifisystem.ru/api.xml?параметры…
Ответ содержит в себе статус запроса, и пару логин/пароль для доступа ваших посетителей.
Пример ответа
формат xml
<voucher>
<result>0</result>
<resulttxt>OK</resulttxt>
<username>zs3x8rf7</username>
<password>6128</password>
<id>408058</id>
</voucher>
Статусы могут принимать следующие значения:
формат xml
<voucher>
<result>0</result>
<resulttxt>OK</resulttxt>
<username>zs3x8rf7</username>
<password>6128</password>
<id>408058</id>
</voucher>
Статусы могут принимать следующие значения:
Изменение ваучера
Для того, чтобы изменить ваучер, необходимо отправить GET или POST запрос на наш сервер https://api.wifisystem.ru/api , указав при этом ряд параметров.
Для того, чтобы изменить ваучер, необходимо отправить GET или POST запрос на наш сервер https://api.wifisystem.ru/api , указав при этом ряд параметров.
Пример GET запроса
https://api.wifisystem.ru/api.xml?act=update_voucher&key=9a9b42a034562a4954a9a30d6b221b
&username=asx7pk29x&amount=72&speed=3&expire=7&data=Иванов%20Сергей%20Викторович&simultaneous=3
Генерация ваучера с одним полем, вход только по логину
Данную функцию можно использовать как «белый список», например вы можете использовать номер «клубной карты» или номер телефона вашего гостя, чтобы предоставить доступ конкретному человеку в Интернет.
Важно понимать, что данный ваучер вы выдаете на постоянное пользование, и параметры amount и expire нужно устанавливать достаточно большими. Так как если ваш гость превысит их ограничения, то доступ к интернету будет заблокирован. Если вы намеренно хотите прекратить действие такого ваучера, то вам нужно будет послать команду на его изменение, например сократив параметр amount или expire до 1 .
Для того, чтобы сгенерировать ваучер, необходимо отправить GET или POST запрос на наш сервер https://api.wifisystem.ru/api , указав при этом ряд параметров.
В настройках хотспота выберите «Ваучеры с одним полем», чтобы гости могли использовать сгенерированные ваучеры этого типа.
https://api.wifisystem.ru/api.xml?act=update_voucher&key=9a9b42a034562a4954a9a30d6b221b
&username=asx7pk29x&amount=72&speed=3&expire=7&data=Иванов%20Сергей%20Викторович&simultaneous=3
Генерация ваучера с одним полем, вход только по логину
Данную функцию можно использовать как «белый список», например вы можете использовать номер «клубной карты» или номер телефона вашего гостя, чтобы предоставить доступ конкретному человеку в Интернет.
Важно понимать, что данный ваучер вы выдаете на постоянное пользование, и параметры amount и expire нужно устанавливать достаточно большими. Так как если ваш гость превысит их ограничения, то доступ к интернету будет заблокирован. Если вы намеренно хотите прекратить действие такого ваучера, то вам нужно будет послать команду на его изменение, например сократив параметр amount или expire до 1 .
Для того, чтобы сгенерировать ваучер, необходимо отправить GET или POST запрос на наш сервер https://api.wifisystem.ru/api , указав при этом ряд параметров.
В настройках хотспота выберите «Ваучеры с одним полем», чтобы гости могли использовать сгенерированные ваучеры этого типа.
Пример GET запроса
https://api.wifisystem.ru/api.xml?act=create_voucher2&key=9a9b42a034562a4954a9a30d6b221b&voucher_type=1
&amount=72&speed=3&expire=7&data=Иванов%20Сергей%20Викторович&simultaneous=3&nasid=your_nasid&username=4442123366558899&password=1
Данный пример генерирует ваучер с типом по времени, суммарным временем на 72 часа, со скоростью доступа 3 мбит/с, который истечет через 7 дней после первой активации.
Ответ вы можете получать в формате текста, json или xml форматов.
https://api.wifisystem.ru/api?параметры…
https://api.wifisystem.ru/api.json?параметры…
https://api.wifisystem.ru/api.xml?параметры…
Ответ содержит в себе статус запроса, и пару логин/пароль для доступа ваших посетителей.
https://api.wifisystem.ru/api.xml?act=create_voucher2&key=9a9b42a034562a4954a9a30d6b221b&voucher_type=1
&amount=72&speed=3&expire=7&data=Иванов%20Сергей%20Викторович&simultaneous=3&nasid=your_nasid&username=4442123366558899&password=1
Данный пример генерирует ваучер с типом по времени, суммарным временем на 72 часа, со скоростью доступа 3 мбит/с, который истечет через 7 дней после первой активации.
Ответ вы можете получать в формате текста, json или xml форматов.
https://api.wifisystem.ru/api?параметры…
https://api.wifisystem.ru/api.json?параметры…
https://api.wifisystem.ru/api.xml?параметры…
Ответ содержит в себе статус запроса, и пару логин/пароль для доступа ваших посетителей.
Пример ответа
формат xml
<voucher>
<result>0</result>
<resulttxt>OK</resulttxt>
<username>4442123366558899-your_nasid</username>
<password>1</password>
<id>408059</id>
</voucher>
Статусы могут принимать следующие значения:
формат xml
<voucher>
<result>0</result>
<resulttxt>OK</resulttxt>
<username>4442123366558899-your_nasid</username>
<password>1</password>
<id>408059</id>
</voucher>
Статусы могут принимать следующие значения:
Изменение ваучера с номером комнаты и датой рождения
Для того, чтобы изменить ваучер, необходимо отправить GET или POST запрос на наш сервер https://api.wifisystem.ru/api , указав при этом ряд параметров.
Для того, чтобы изменить ваучер, необходимо отправить GET или POST запрос на наш сервер https://api.wifisystem.ru/api , указав при этом ряд параметров.
Пример GET запроса
https://api.wifisystem.ru/api.xml?act=update_voucher3&key=9a9b42a034562a4954a9a30d6b221b&amount=3000
&speed=100&expire=100&data=Иванов%20Сергей%20Викторович&simultaneous=3&nasid=your_nasid&username=4442123366558899
https://api.wifisystem.ru/api.xml?act=update_voucher3&key=9a9b42a034562a4954a9a30d6b221b&amount=3000
&speed=100&expire=100&data=Иванов%20Сергей%20Викторович&simultaneous=3&nasid=your_nasid&username=4442123366558899
Получение номера телефона и MAC-адреса после авторизации (Webhook)
В момент завершения процесса авторизации данные о посетителе могут быть переданы в вашу информационную систему.
Для получения данных об авторизованных пользователях Вы можете использовать специальные теги в параметрах.
В момент завершения процесса авторизации данные о посетителе могут быть переданы в вашу информационную систему.
Для получения данных об авторизованных пользователях Вы можете использовать специальные теги в параметрах.
Теги задаются при настройки хотспота в личном кабинете в поле "Ссылка для перенаправления пользователя", например так:
http://your-site.ru/?phone={phone}&mac={mac}&signature={signature}&nasid={nasid}
URL обязательно должен начинаться с http, использовать https нельзя.
http://your-site.ru/?phone={phone}&mac={mac}&signature={signature}&nasid={nasid}
URL обязательно должен начинаться с http, использовать https нельзя.
Управление Хотспотом.
Можно блокировать, разблокировать и узнать статус хотспота.
Можно блокировать, разблокировать и узнать статус хотспота.
Блокировка хотспота
https://api.wifisystem.ru/api?act=block_hotspot&key={key}&nasid={nasid}&uamsecret={uamsecret}
Разблокировка хотспота
https://api.wifisystem.ru/api?act=unlock_hotspot&key={key}&nasid={nasid}&uamsecret={uamsecret}
Получение Статуса хотспота
https://api.wifisystem.ru/api?act=get_hotspot_status&key={key}&nasid={nasid}&uamsecret={uamsecret}
Возвращаемые статусы
https://api.wifisystem.ru/api?act=block_hotspot&key={key}&nasid={nasid}&uamsecret={uamsecret}
Разблокировка хотспота
https://api.wifisystem.ru/api?act=unlock_hotspot&key={key}&nasid={nasid}&uamsecret={uamsecret}
Получение Статуса хотспота
https://api.wifisystem.ru/api?act=get_hotspot_status&key={key}&nasid={nasid}&uamsecret={uamsecret}
Возвращаемые статусы
Получение Баланса
Запрос баланса лицевого счёта:
https://api.wifisystem.ru/api?act=get_balance&key={key}
Запрос баланса лицевого счёта:
https://api.wifisystem.ru/api?act=get_balance&key={key}
Получаемый ответ:
Отправка данных опроса (Webhook)
Во время авторизации вы можете провести опрос своего гостя. Чтобы данные опроса попадали в вашу систему в режиме онлайн, вы можете указать URL вашего сервера в настройках хотспота — Дополнительные функции — Опросы. Данные передаются в теле POST запроса в формате JSON-строки.
Отправка данных Сенсором (Webhook)
Возможность отправлять GET запросы в вашу информационную систему: для отправки PUSH-уведомлений посетителям через собственное приложение с рекламными акциями, для анализа поведения посетителей и т.п.
В настройках Wi-Fi Сенсора необходимо указать ссылку на обработчик на вашем сервере:
https://yoursite.ru/webhook_function/
В момент обнаружения устройства Wi-Fi Сенсором наш сервер отправит данные по указанному адресу.
Пример получаемых данных:
{ mac:00112233445566, phone:9991234567, nasid:your_nasid_1 }
Во время авторизации вы можете провести опрос своего гостя. Чтобы данные опроса попадали в вашу систему в режиме онлайн, вы можете указать URL вашего сервера в настройках хотспота — Дополнительные функции — Опросы. Данные передаются в теле POST запроса в формате JSON-строки.
Отправка данных Сенсором (Webhook)
Возможность отправлять GET запросы в вашу информационную систему: для отправки PUSH-уведомлений посетителям через собственное приложение с рекламными акциями, для анализа поведения посетителей и т.п.
В настройках Wi-Fi Сенсора необходимо указать ссылку на обработчик на вашем сервере:
https://yoursite.ru/webhook_function/
В момент обнаружения устройства Wi-Fi Сенсором наш сервер отправит данные по указанному адресу.
Пример получаемых данных:
{ mac:00112233445566, phone:9991234567, nasid:your_nasid_1 }
API-Connector — авторизация через вашу базу данных
Ваш гость для подключения к сети Интернет вводит определяемую вами информацию, например, номер комнаты, номер бронирования или номер договора. Наша система делает запрос к API-Connector и тот в свою очередь к вашему серверу базы данных. В случае, если введенные гостем данные совпадают с данными в вашей БД, наша система открывает ему доступ доступ в интернет.
Интеграция индивидуальная.
Ваш гость для подключения к сети Интернет вводит определяемую вами информацию, например, номер комнаты, номер бронирования или номер договора. Наша система делает запрос к API-Connector и тот в свою очередь к вашему серверу базы данных. В случае, если введенные гостем данные совпадают с данными в вашей БД, наша система открывает ему доступ доступ в интернет.
Интеграция индивидуальная.