Лимитированные ссылки

Лимитированные ссылки — это функция, которая позволяет ограничить количество устройств, способных добавить подписку (ссылку) в приложение. В личном кабинете на сайте happ-proxy.com вы указываете URL вашей подписки, задаёте максимальное количество устройств и нажимаете "Сгенерировать ссылку". Полученную ссылку можно передать пользователю, при этом вы можете быть уверены: подписку смогут установить только указанное количество устройств — превышение лимита невозможно.

Создавать лимитированные ссылки можно как через веб‑интерфейс, так и с помощью API.

Создание через сайт

  1. На странице создания укажите незашифрованный URL вашей подписки.

  2. Задайте лимит установок (максимальное число устройств).

  3. После генерации:

    • К URL автоматически добавляется параметр InstallID.

    • Домен ссылки сохраняется в базе в виде SHA‑256‑хеша (сырые домены не хранятся для повышения безопасности).

Вы получите зашифрованную ссылку с параметром InstallID.


Создание через API

Отправьте GET‑запрос на адрес:

  • {provider_code} — ваш код провайдера (в профиле)

  • {auth_key} — ключ авторизации (в профиле)

  • {install_limit} — максимальное число устройств

Ответ API

  • Успех

  • Ошибка

Добавьте полученный install_code в ссылку как параметр InstallID.


Пример

  • Исходный URL:

  • Итоговая ссылка:

Совет: Зашифруйте ссылку, чтобы пользователи не могли удалить параметр InstallID.


Принцип работы

При добавлении ссылки приложение вычисляет SHA‑256-хеш домена и отправляет запрос на:

В ответ возвращаются ProviderID и статус ссылки.

Если запрос не удаётся передать (например, из-за блокировки сайта), приложение автоматически повторит попытку после установки VPN-соединения.

Сервер happ-proxy.com получает HWID устройства и отвечает положительно, если лимит установок по ссылке не превышен. В случае превышения лимита сервер возвращает отказ, и приложение выводит сообщение: «Администратор подписки ограничил доступ. Пожалуйста, свяжитесь с технической поддержкой.»

Last updated