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

Лимитированные ссылки — это функция, которая позволяет ограничить количество устройств, способных добавить подписку (ссылку) в приложение.

В личном кабинете на сайте happ-proxy.comвы указываете URL вашей подписки, задаёте максимальное количество устройств и нажимаете "Сгенерировать ссылку".

Полученную ссылку можно передать пользователю, при этом вы можете быть уверены: подписку смогут установить только указанное количество устройств — превышение лимита невозможно.

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

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

1. На странице создания укажите незашифрованный URL вашей подписки.
2. Задайте лимит установок (максимальное число устройств).
3. После генерации:
   • К 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} — максимальное число устройств

• Успех
  Copy

  {
      "rc": 1,
      "msg": "Ok",
      "install_code": "6P0hVao1fG5e"
  }

• Ошибка
  Copy

  {
      "rc": 0,
      "msg": "Описание ошибки"
  }

Пример

• Исходный URL:
  Copy

  https://url.com/sub

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

  https://url.com/sub#Your_TITLE?installid=Abcd1234

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

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

https://check.happ-proxy.com/install?id={domain_hash}&installid={InstallID}

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

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

Сервер happ-proxy.com получает HWID устройства и отвечает положительно, если лимит установок по ссылке не превышен.

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