Лимитированные ссылки
Лимитированные ссылки — это функция, которая позволяет ограничить количество устройств, способных добавить подписку (ссылку) в приложение.
В личном кабинете на сайте happ-proxy.com вы указываете URL вашей подписки, задаёте максимальное количество устройств и нажимаете "Сгенерировать ссылку".
Полученную ссылку можно передать пользователю, при этом вы можете быть уверены: подписку смогут установить только указанное количество устройств — превышение лимита невозможно.
Создавать лимитированные ссылки можно как через веб‑интерфейс, так и с помощью API.
Создание через сайт
На странице создания укажите незашифрованный URL вашей подписки.
Задайте лимит установок (максимальное число устройств).
После генерации:
К URL автоматически добавляется параметр InstallID.
Домен ссылки сохраняется в базе в виде SHA‑256‑хеша (сырые домены не хранятся для повышения безопасности).
Вы получите зашифрованную ссылку с параметром InstallID.
Создание через API
Отправьте GET‑запрос на адрес:
https://api.happ-proxy.com/api/add-install?
provider_code={provider_code}&
auth_key={auth_key}&
install_limit={install_limit}{provider_code} — ваш код провайдера (в профиле)
{auth_key} — ключ авторизации (в профиле)
{install_limit} — максимальное число устройств
Ответ API
Успех
{ "rc": 1, "msg": "Ok", "install_code": "6P0hVao1fG5e" }Ошибка
{ "rc": 0, "msg": "Описание ошибки" }
Добавьте полученный install_code в ссылку как параметр InstallID.
Пример
Исходный URL:
https://url.com/subИтоговая ссылка:
https://url.com/sub#Your_TITLE?installid=Abcd1234
Совет: Зашифруйте ссылку, чтобы пользователи не могли удалить параметр InstallID.
Принцип работы
При добавлении ссылки приложение вычисляет SHA‑256-хеш домена и отправляет запрос на:
https://check.happ-proxy.com/install?id={domain_hash}&installid={InstallID}В ответ возвращаются ProviderID и статус ссылки.
Если запрос не удаётся передать (например, из-за блокировки сайта), приложение автоматически повторит попытку после установки VPN-соединения.
Сервер happ-proxy.com получает HWID устройства и отвечает положительно, если лимит установок по ссылке не превышен. В случае превышения лимита сервер возвращает отказ, и приложение выводит сообщение:
«Администратор подписки ограничил доступ. Пожалуйста, свяжитесь с технической поддержкой.»
Last updated