Deeplink-действия happ://

Обычная ссылка в интернете начинается с http:// или https:// и открывает страницу в браузере. Диплинк использует собственную схему адреса — в случае Happ это happ://. Приложение регистрирует эту схему в операционной системе при установке, и система запоминает: ссылки такого вида нужно открывать не в браузере, а в Happ.

Когда пользователь нажимает диплинк — в чате, на сайте провайдера или в письме, — система сразу передаёт содержимое ссылки установленному приложению. Браузер и промежуточные страницы в этом процессе не участвуют.

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

Документация Happ описывает диплинк как один из нескольких равнозначных способов передать в приложение одни и те же данные — наряду с буфером обмена и QR-кодом. Выбор канала зависит от ситуации, а не от типа данных.

Для протокольных ссылок вроде vless:// или vmess:// все три канала равноценны: приложение одинаково разберёт адрес независимо от способа передачи. Ручной ввод через кнопку «+» на главном экране остаётся четвёртым способом — там пользователь вводит параметры сервера сам, без готовой ссылки.

Официальная документация Happ прямо описывает три действия для управления профилями маршрутизации:

Значение {base64} — это JSON-описание профиля, переведённое в текстовый формат base64. Такие ссылки генерирует сайт routing.happ.su, но их можно передать и другими способами — HTTP-заголовком routing в ответе сервера подписки или строкой в её теле.

Отдельная категория — ссылки happ://crypto…, которые добавляют зашифрованную подписку. После такого импорта пользователь не видит и не может отредактировать адрес подписки и параметры серверов: ключи шифрования встроены в само приложение, а зашифровать исходную ссылку провайдер может на странице crypto.happ.su или через API.

Помимо этих действий, диплинком в Happ открываются и обычные ссылки протоколов — vless://, vmess://, trojan://, ss://, socks://, hysteria2:// и hy2://, а также ссылки на обычные подписки. Формально это тот же механизм: система направляет ссылку в приложение, а Happ определяет по её началу, что с ней делать.

Если часть адреса после happ:// не совпадает ни с одним известным действием, Happ показывает ошибку «Неизвестное действие DeepLink» и игнорирует ссылку — настройки при этом не меняются. Подробный разбор причин и порядок проверки — на странице ошибки «Неизвестное действие DeepLink».

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

На Android TV подписка обычно приходит не диплинком, а через отдельный веб-механизм: сайт tv.happ.su или прямой POST-запрос к check.happ.su/sendtv/{код} с телом в формате JSON. Причина простая — на телевизоре неудобно набирать ссылку или сканировать её вручную, поэтому Happ использует пятизначный код устройства вместо диплинка. Устройство и техническую сторону этого API разбирает страница Android TV API Happ.

На Apple TV используется третий подход — импорт по локальной сети через QR-код с телефона или тот же Web Import, а не программный API.

Похожая логика есть и у HWID-ссылок с лимитированными ссылками: формально это обычные подписки, но с дополнительными параметрами в адресе, а не отдельные действия happ://.