Android TV API Happ

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

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

При первом запуске Happ на Android TV показывает экран Web Import с 5-значным кодом. Это тот же код, что используется и при ручном, и при программном способе передачи — разница только в том, что происходит дальше.

Запрос отправляется методом POST на адрес:

https://check.happ.su/sendtv/[код]

где [код] — те самые 5 цифр с экрана телевизора. Тело запроса — JSON с одним полем:

{ "data": "base64" }

Значение base64 — это подписка или конфигурация сервера, сначала записанная как обычная ссылка, а затем закодированная в base64. Пример из документации Happ на curl:

curl -X POST https://check.happ.su/sendtv/QWET5 \
  -H "Content-Type: application/json" \
  -d '{"data":"aHR0cHM6Ly9leGFtcGxlLmNvbS9zdWI="}'

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

Ручной ввод через tv.happ.su и QR-код подходят, когда рядом с телевизором есть человек с телефоном или доступом к браузеру. API полезен в других сценариях:

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

На Apple TV отдельного программного API нет: там подписку передают через локальную сеть QR-кодом с телефона, где установлен Happ, либо тем же Web Import через сайт tv.happ.su — но без прямого HTTP-запроса, описанного для Android TV. Это связано с тем, что «Happ — Proxy Utility for TV» на Apple TV — самостоятельный продукт с собственными ограничениями платформы.

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