Генерация ваучера

Стандартный ваучер для авторизации

Если вы используете автоматизированную систему управления отелем, такую как Fidelio, Opera, 1C, вы можете настроить её на взаимодействие с нашим сервисом. Например, при заселении гостя в момент, когда вы вносите его персональные данные, вы можете отправить запрос на генерацию ваучера. В запросе вы указываете требуемые параметры, например, скорость доступа и время действия ваучера, и в ответ получаете пару логин/пароль, которые можно распечатать и передать гостю. Также, если пожелаете хранить персональные данные о пользователях в нашей системе, можно передать их с помощью необязательных параметров.

Для того, чтобы сгенерировать ваучер, необходимо отправить GET или POST запрос на наш сервер https://api.1wifi.ru/api , указав при этом ряд параметров.

В настройках хотспота выберите «Стандартные Ваучеры», чтобы гости могли использовать сгенерированные ваучеры этого типа.

Параметр Описание Тип
act нужно передать значение create_voucher обязательный
key API ключ, находится в личном кабинете в «Профиле пользователя» обязательный
voucher_type Тип ваучера. Возможные значения: 1 — учёт по времени, 2 — учёт по трафику обязательный
amount Номинал ваучера, период в часах или объем в мегабайтах. Задается в зависимости от выбранного типа обязательный
speed Скорость доступа к сети Интернет, в мбит/сек. 0 — скорость неограничена обязательный
expire Срок в течение которого ваучер остается годным , после первой активации, в днях обязательный
data Персональные данные о пользователе. ФИО, дата рождения, место рождения и т.п. необязательный
simultaneous Максимальное количество подключенных устройств на один ваучер. По умолчанию — 5 необязательный

Пример GET запроса

https://api.1wifi.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.1wifi.ru/api?параметры…
https://api.1wifi.ru/api.json?параметры…
https://api.1wifi.ru/api.xml?параметры…

Ответ содержит в себе статус запроса, и пару логин/пароль для доступа ваших посетителей.

Параметр Описание статуса
result Код ответа
resulttxt Текстовая расшифровка кода
username Логин
password Пароль
id Идентификатор Ваучера

Пример ответа

формат xml

<voucher>
<result>0</result>
<resulttxt>OK</resulttxt>
<username>zs3x8rf7</username>
<password>6128</password>
<id>408058</id>
</voucher>

Статусы могут принимать следующие значения:

Код статуса, result Описание статуса, resulttxt
0 ОК
1 Несуществующий API key
2 Несуществующий тип ваучера
3 Отсутствуют обязательные параметры
5 Превышен разрешенный суточный лимит по созданию ваучеров
7 Генерация ваучеров запрещена
8 Недостаточно денег на балансе
9 Значение слишком мало
10 Значение слишком велико

Изменение ваучера

Для того, чтобы изменить ваучер, необходимо отправить GET или POST запрос на наш сервер https://api.1wifi.ru/api , указав при этом ряд параметров.

Параметр Описание Тип
act нужно передать значение update_voucher обязателный
key API ключ, находится в личном кабинете в «Профиле пользователя» обязательный
username Логин ваучера обязательный
amount Номинал ваучера, период в часах или объем в мегабайтах. Задается в зависимости от выбранного типа обязательный
speed Скорость доступа к сети Интернет, в мбит/сек. 0 — скорость неограничена обязательный
expire Срок в течение которого ваучер остается годным , после первой активации, в днях обязательный
data Персональные данные о пользователе. ФИО, дата рождения, место рождения и т.п. необязательный
simultaneous Максимальное количество подключенных устройств на один ваучер. По умолчанию — 5 необязательный

Пример GET запроса

https://api.1wifi.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.1wifi.ru/api , указав при этом ряд параметров.

В настройках хотспота выберите «Ваучеры с одним полем», чтобы гости могли использовать сгенерированные ваучеры этого типа.

 

Параметр Описание Тип
act нужно передать значение create_voucher2 обязателный
key API ключ, находится в личном кабинете в «Профиле пользователя» обязательный
voucher_type Тип ваучера. Возможные значения: 1 — учёт по времени, 2 — учёт по трафику обязательный
amount Номинал ваучера, период в часах или объем в мегабайтах. Задается в зависимости от выбранного типа обязательный
speed Скорость доступа к сети Интернет, в мбит/сек. 0 — скорость неограничена обязательный
expire Срок в течение которого ваучер остается годным , после первой активации, в днях обязательный
data Персональные данные о пользователе. ФИО, дата рождения, место рождения и т.п. необязательный
simultaneous Максимальное количество подключенных устройств на один ваучер. По умолчанию — 5 необязательный
username Логин для входа, например номер «клубной карты» обязательный
password Пароль, всегда нужна указывать 1 обязательный
nasid NAS ID хотспота обязательный

Пример GET запроса

https://api.1wifi.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.1wifi.ru/api?параметры…
https://api.1wifi.ru/api.json?параметры…
https://api.1wifi.ru/api.xml?параметры…

Ответ содержит в себе статус запроса, и пару логин/пароль для доступа ваших посетителей.

Параметр Описание статуса
result Код ответа
resulttxt Текстовая расшифровка кода
username Логин
password Пароль, всегда 1
id Идентификатор Ваучера

Пример ответа

формат xml

<voucher>
<result>0</result>
<resulttxt>OK</resulttxt>
<username>4442123366558899-your_nasid</username>
<password>1</password>
<id>408059</id>
</voucher>

Статусы могут принимать следующие значения:

Код статуса, result Описание статуса, resulttxt
0 ОК
1 Несуществующий API key
2 Несуществующий тип ваучера
3 Отсутствуют обязательные параметры
5 Превышен разрешенный суточный лимит по созданию ваучеров
7 Генерация ваучеров запрещена
8 Недостаточно денег на балансе
9 Значение слишком мало
10 Значение слишком велико

Изменение ваучера с одним полем

Для того, чтобы изменить ваучер, необходимо отправить GET или POST запрос на наш сервер https://api.1wifi.ru/api , указав при этом ряд параметров.

Параметр Описание Тип
act нужно передать значение update_voucher2 обязателный
key API ключ, находится в личном кабинете в «Профиле пользователя» обязательный
username Логин ваучера обязательный
amount Номинал ваучера, период в часах или объем в мегабайтах. Задается в зависимости от выбранного типа обязательный
speed Скорость доступа к сети Интернет, в мбит/сек. 0 — скорость неограничена обязательный
expire Срок в течение которого ваучер остается годным , после первой активации, в днях обязательный
data Персональные данные о пользователе. ФИО, дата рождения, место рождения и т.п. необязательный
simultaneous Максимальное количество подключенных устройств на один ваучер. По умолчанию — 5 необязательный
nasid NAS ID хотспота обязательный

Пример GET запроса

https://api.1wifi.ru/api.xml?act=update_voucher2&key=9a9b42a034562a4954a9a30d6b221b&amount=3000
&speed=100&expire=100&data=Иванов%20Сергей%20Викторович&simultaneous=3&nasid=your_nasid&username=4442123366558899

 

Генерация ваучера с номером комнаты и датой рождения

Ваучер с номером комнаты и датой рождения
В качестве логина используется номер комнаты, а в качестве паролядата рождения гостя, что очень удобно, вашему гостю не нужно запоминать учётные данные, чтобы подключиться к Интернет.

Для того, чтобы сгенерировать ваучер, необходимо отправить GET или POST запрос на наш сервер https://api.1wifi.ru/api , указав при этом ряд параметров.

В настройках хотспота выберите «Ваучеры с номером комнаты и датой рождения», чтобы гости могли использовать сгенерированные ваучеры этого типа.

Параметр Описание Тип
act нужно передать значение create_voucher3 обязателный
key API ключ, находится в личном кабинете в «Профиле пользователя» обязательный
voucher_type Тип ваучера. Возможные значения: 1 — учёт по времени, 2 — учёт по трафику обязательный
amount Номинал ваучера, период в часах или объем в мегабайтах. Задается в зависимости от выбранного типа обязательный
speed Скорость доступа к сети Интернет, в мбит/сек. 0 — скорость неограничена обязательный
expire Срок в течение которого ваучер остается годным , после первой активации, в днях обязательный
data Персональные данные о пользователе. ФИО, дата рождения, место рождения и т.п. необязательный
simultaneous Максимальное  количество подключенных устройств на один ваучер. По умолчанию — 5 необязательный
username Логин для входа, например номер комнаты обязательный
password Пароль, обязательно в формате YYYYMMDD обязательный
nasid NAS ID хотспота обязательный

Пример GET запроса

https://api.1wifi.ru/api.xml?act=create_voucher3&key=9a9b42a034562a4954a9a30d6b221b&voucher_type=1&amount=72
&speed=3&expire=7&data=Иванов%20Сергей%20Викторович&simultaneous=3&nasid=your_nasid&username=315&password=19830327

Данный пример генерирует ваучер с типом по времени, суммарным временем на 72 часа, со скоростью доступа 3 мбит/с, который истечет через 7 дней после первой активации.

Ответ вы можете получать в формате текста, json или xml форматов.

https://api.1wifi.ru/api?параметры…
https://api.1wifi.ru/api.json?параметры…
https://api.1wifi.ru/api.xml?параметры…

Ответ содержит в себе статус запроса, и пару логин/пароль для доступа ваших посетителей.

Параметр Описание статуса
result Код ответа
resulttxt Текстовая расшифровка кода
username Логин
password Пароль, дата рождения YYYYMMDD
id Идентификатор Ваучера

Пример ответа

формат xml

<voucher>
<result>0</result>
<resulttxt>OK</resulttxt>
<username>315</username>
<password>19830327</password>
<id>408057</id>
</voucher>

Статусы могут принимать следующие значения:

Код статуса, result Описание статуса, resulttxt
0 ОК
1 Несуществующий API key
2 Несуществующий тип ваучера
3 Отсутствуют обязательные параметры
5 Превышен разрешенный суточный лимит по созданию ваучеров
7 Генерация ваучеров запрещена
8 Недостаточно денег на балансе
9 Значение слишком мало
10 Значение слишком велико

Изменение ваучера с номером комнаты и датой рождения

Для того, чтобы изменить ваучер, необходимо отправить GET или POST запрос на наш сервер https://api.1wifi.ru/api , указав при этом ряд параметров.

Параметр Описание Тип
act нужно передать значение update_voucher2 обязателный
key API ключ, находится в личном кабинете в «Профиле пользователя» обязательный
username Логин ваучера обязательный
password Пароль ваучера обязательный
amount Номинал ваучера, период в часах или объем в мегабайтах. Задается в зависимости от выбранного типа обязательный
speed Скорость доступа к сети Интернет, в мбит/сек. 0 — скорость неограничена обязательный
expire Срок в течение которого ваучер остается годным , после первой активации, в днях обязательный
data Персональные данные о пользователе. ФИО, дата рождения, место рождения и т.п. необязательный
simultaneous Максимальное количество подключенных устройств на один ваучер. По умолчанию — 5 необязательный
nasid NAS ID хотспота обязательный

Пример GET запроса

https://api.1wifi.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)

API параметры при авторизации Wi-Fi

В момент завершения процесса авторизации данные о посетителе могут быть переданы в вашу информационную систему.

Для получения данных об авторизованных пользователях Вы можете использовать специальные теги в параметрах.

Тег Описание Тип
{phone} Номер телефона посетителя необязательный
{mac} MAC-адрес устройства посетителя необязательный
{signature} Служит для проверки присылаемых параметров. Формируется как md5(phone+mac+API ключ). API ключ, находится в личном кабинете в «Профиле пользователя» необязательный
{nasid} Идентификатор хотспота на котором произошла авторизация необязательный

Теги задаются при настройки хотспота в личном кабинете в поле «Ссылка для перенаправления пользователя«, например так:

http://your-site.ru/?phone={phone}&mac={mac}&signature={signature}&nasid={nasid}

URL обязательно должен начинаться с http, использовать https нельзя.

Управление Хотспотом.

Можно блокировать, разблокировать и узнать статус хотспота.

Тег Описание Тип
{key} API ключ, находится в личном кабинете в «Профиле пользователя» обязательный
{nasid} Идентификатор хотспота(NAS ID) обязательный
{uamsecret} Пароль (UAM Secret) обязательный

Блокировка хотспота

https://api.1wifi.ru/api?act=block_hotspot&key={key}&nasid={nasid}&uamsecret={uamsecret}

Разблокировка хотспота

https://api.1wifi.ru/api?act=unlock_hotspot&key={key}&nasid={nasid}&uamsecret={uamsecret}

Получение Статуса хотспота

https://api.1wifi.ru/api?act=get_hotspot_status&key={key}&nasid={nasid}&uamsecret={uamsecret}

Возвращаемые статусы

Параметр, result Описание статуса, resulttxt
501 Хотспот в состоянии — разблокирован
502 Хотспот в состоянии — заблокирован
503 Хотспот разблокирован
504 Хотспот заблокирован
505 Хотспот уже разблокирован
506 Хотспот уже заблокирован

Получение Баланса

Запрос баланса лицевого счёта:

https://api.1wifi.ru/api?act=get_balance&key={key}

Тег Описание Тип
{key} API ключ, находится в личном кабинете в «Профиле пользователя» обязательный

Получаемый ответ:

Параметр Описание
balance Баланс лицевого счёта

Отправка данных опроса (Webhook)

Во время авторизации вы можете провести опрос своего гостя. Чтобы данные опроса попадали в вашу систему в режиме онлайн, вы можете указать URL вашего сервера в настройках хотспота — Дополнительные функции — Опросы. Данные передаются в теле POST запроса в формате JSON-строки.

Адрес обработчика опросов на вашем сервере

Отправка данных Сенсором (Webhook)

Возможность отправлять GET запросы в вашу информационную систему: для отправки PUSH-уведомлений посетителям через собственное приложение с рекламными акциями, для анализа поведения посетителей и т.п.
В настройках Wi-Fi Сенсора необходимо указать ссылку на обработчик на вашем сервере:

https://yoursite.ru/webhook_function/

В момент обнаружения устройства Wi-Fi Сенсором наш сервер отправит данные по указанному адресу.
Пример получаемых данных:

{ mac:00112233445566, phone:9991234567, nasid:your_nasid_1 }

Параметр Описание
mac МАС адрес устройства
phone Номер телефона устройства(если известен)
nasid Nasid Сенсора

API-Connector — авторизация через вашу базу данных

API-ConnectorВаш гость для подключения к сети Интернет вводит определяемую вами информацию, например, номер комнаты, номер бронирования или номер договора. Наша система делает запрос к API-Connector и тот в свою очередь к вашему серверу базы данных. В случае, если введенные гостем данные совпадают с данными в вашей БД, наша система открывает ему доступ доступ в интернет.
Интеграция индивидуальная.
Более подробная информация здесь.