Как импортировать профиль маршрутизации

Профиль маршрутизации — это JSON-объект с правилами. Импорт — доставка этого объекта в Happ одним из поддерживаемых способов, чтобы он появился в списке профилей нужной подписки.

Профиль превращают в ссылку happ://routing/add/{base64} или happ://routing/onadd/{base64}, где {base64} — сам JSON, закодированный в base64. Такую ссылку собирает генератор на сайте routing.happ.su, если писать JSON вручную не хочется.

Дальше ссылку передают: через диплинк (переход по ссылке сразу открывает Happ), буфер обмена, QR-код, а для провайдеров с Provider ID — через HTTP-заголовок routing в ответе сервера подписки или строку в её теле. При таком способе профиль сразу привязывается к подписке, в которой пришёл.

1. 1

   Подготовьте профиль

   Соберите профиль на routing.happ.su или получите готовую ссылку с happ://routing/add или .../onadd от провайдера.

   Результат: У вас есть готовый JSON-профиль или ссылка от провайдера.

2. 2

   Выберите способ доставки

   Для собственного устройства подойдёт буфер обмена или прямой переход по ссылке, для другого устройства — QR-код.

   Результат: Ссылка доступна в виде текста, QR-кода или как диплинк для перехода.

3. 3

   Передайте ссылку в Happ

   Вставьте ссылку через тот же способ, что и для добавления сервера, отсканируйте QR-код или перейдите по диплинку из чата или почты.

   Результат: Приложение открылось и обрабатывает данные ссылки.

4. 4

   Проверьте, что профиль появился в списке

   Результат: Новый профиль виден в настройках маршрутизации нужной подписки.

5. 5

   Дождитесь загрузки geo-файлов

   Первый профиль подписки становится активным только после того, как этот шаг завершится успешно.

   Результат: Рядом с профилем нет красного восклицательного знака.

6. 6

   Если использовали ссылку onadd — убедитесь, что профиль стал активным

   Результат: Именно этот профиль отмечен как текущий у подписки.

7. 7

   Переподключитесь к серверу

   Результат: Соединение установлено заново с правилами из импортированного профиля.

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

Это удобно, когда нужно скорректировать уже работающий профиль: соберите новую версию с тем же значением поля Name в генераторе или вручную и импортируйте её тем же способом, что и в первый раз.

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