1 Wi-Fi - Генерация ваучера
- Изменение ваучера
- Генерация ваучера с одним полем
- Изменение ваучера с одним полем
- Генерация ваучера с номером комнаты и датой рождения
- Изменение ваучера с номером комнаты и датой рождения
- Получение номера телефона и MAC-адреса после авторизации (Webhook)
- Управление Хотспотом
- Получение Баланса
- Отправка данных опроса (Webhook)
- Отправка данных Сенсором (Webhook)
- API-Connector — авторизация через вашу базу данных
Генерация ваучера
Если вы используете автоматизированную систему управления отелем, такую как 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)
В момент завершения процесса авторизации данные о посетителе могут быть переданы в вашу информационную систему.
Для получения данных об авторизованных пользователях Вы можете использовать специальные теги в параметрах.
| Тег | Описание | Тип |
|---|---|---|
| {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 и тот в свою очередь к вашему серверу базы данных. В случае, если введенные гостем данные совпадают с данными в вашей БД, наша система открывает ему доступ доступ в интернет.
Интеграция индивидуальная.
Более подробная информация здесь.