Лимитированные ссылки для провайдеров

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

В отличие от HWID-ссылки, которая заранее знает HWID устройства, лимитированная ссылка не привязана к конкретному оборудованию. Она просто ограничивает общее количество, а какие именно устройства его займут — решает порядок обращений. Как и HWID-ссылки, лимитированные ссылки передаются диплинком, буфером обмена или QR-кодом — подробнее о каналах передачи на странице диплинков happ://.

Документация Happ описывает два равноценных способа.

Через сайт. В личном кабинете happ-proxy.com провайдер указывает незашифрованный адрес подписки и лимит установок. Сервис добавляет к адресу параметр InstallID, шифрует итоговую ссылку и сохраняет домен подписки в виде SHA-256-хеша, а не в открытом виде.

Через API. GET-запрос на адрес api.happ-proxy.com/api/add-install с тремя параметрами:

provider_code={provider_code}
auth_key={auth_key}
install_limit={install_limit}

Успешный ответ приходит в формате JSON с кодом install_code, который нужно подставить в адрес подписки как значение параметра InstallID:

https://example.com/sub#Название?installid=install_code

Документация советует шифровать готовую ссылку — иначе пользователь технически может удалить параметр InstallID из адреса и обойти проверку лимита.

Когда пользователь добавляет лимитированную ссылку в Happ, приложение выполняет проверку до того, как подписка появится в списке:

1. Вычисляет SHA-256-хеш домена подписки.
2. Отправляет запрос на check.happ-proxy.com/install с этим хешем, значением InstallID и HWID устройства.
3. Получает в ответ ProviderID и статус ссылки — можно добавлять подписку или лимит исчерпан.

Если лимит не превышен, подписка добавляется как обычная. Если превышен — Happ показывает сообщение об ограничении доступа администратором подписки и предлагает обратиться в техподдержку; сама подписка на это устройство не устанавливается.

Запрос к серверу проверки может не пройти, например если сайт check.happ-proxy.com временно заблокирован провайдером интернета пользователя. В этом случае Happ, по документации, автоматически повторит запрос после того, как устройство подключится к VPN через один из серверов подписки.

Provider ID и зашифрованная подписка — соседние темы: провайдер часто сочетает лимит установок с шифрованием адреса, чтобы пользователь не смог ни превысить лимит, ни увидеть исходный сервер.

На практике провайдер выбирает инструмент под задачу: лимит подходит для продажи «на N устройств» без привязки к конкретным телефонам, а HWID-ссылка — когда устройство уже известно заранее. Оба инструмента управляют только добавлением подписки, а её дальнейшее обновление на устройстве работает как обычно — см. обновление подписки в Happ.