subscription-userinfo: что это
- Автор
- Екатерина Лебедева, редактор раздела knowledge base
- Проверил:
- Артём Волков
- Проверено:
- Опубликовано:
- , обновлено
- Версия гайда:
- 1.0
Коротко
subscription-userinfo — параметр подписки Happ, который передаёт объём использованного и общего трафика, а также срок действия подписки одной строкой: upload, download, total и expire в формате unix-времени. Приложение показывает эти данные в строке состояния подписки.
subscription-userinfo — строка с четырьмя значениями, разделёнными точкой с запятой: upload и download — израсходованный трафик в байтах, total — общий лимит, expire — дата окончания подписки в формате unix-времени. Провайдер передаёт всю строку одним HTTP-заголовком ответа сервера подписки или строкой с # в начале её тела. Happ складывает upload и download и показывает слева от знака «/» израсходованный трафик, а справа — значение total. Дату из expire приложение переводит в привычный календарный вид.
subscription-userinfo — параметр подписки Happ, который одной строкой передаёт объём использованного трафика, общий лимит и срок действия подписки. Значения upload, download, total указываются в байтах, expire — в формате unix-времени; вся строка разделена точкой с запятой.
Суть термина
subscription-userinfo — параметр подписки, которым провайдер передаёт данные о трафике и сроке её действия. В отличие от profile-title или интервала обновления, здесь не одно значение, а сразу четыре в одной строке.
Формат такой: upload=число; download=число; total=число; expire=число. Первые три — байты, четвёртое — unix-время окончания подписки. Разделитель между значениями — точка с запятой.
Happ читает эту строку при каждом обновлении подписки и превращает сырые числа в понятный пользователю вид: сумму трафика, общий лимит и календарную дату вместо unix-времени.
Как это выглядит в Happ
В интерфейсе Happ данные из subscription-userinfo превращаются в строку состояния подписки: слева — уже израсходованный трафик, полученный сложением upload и download, справа после знака «/» — значение total. Дата из expire показывается как обычная календарная дата окончания.
Эта строка появляется в шапке блока подписки на главном экране рядом с остальными элементами управления. Если провайдер не передал subscription-userinfo, строка состояния для этой подписки не отображается — Happ не показывает данные, которых у него нет.
Обновляются эти цифры вместе со всей подпиской: при ручном или автоматическом обновлении Happ заново запрашивает ответ сервера и получает свежее значение subscription-userinfo, если провайдер его обновил на своей стороне.
Пример параметра в ответе подписки
Через HTTP-заголовок ответа сервера подписки:
subscription-userinfo: upload=0; download=2153701362; total=0; expire=1790951622Тот же результат — строкой в начале тела ответа перед списком конфигураций:
#subscription-userinfo: upload=0; download=2153701362; total=0; expire=1790951622
vless://00000000-0000-0000-0000-000000000000@example.com:443#ExampleHapp покажет израсходованный трафик около двух гигабайт, лимит total как безлимитный (значение 0) и дату окончания, соответствующую unix-времени 1790951622.
Чем отличается от похожих терминов
| Термин | Что показывает |
|---|---|
| subscription-userinfo | трафик (upload, download, total) и срок действия (expire) подписки |
| profile-title | название подписки, не связано с трафиком |
| profile-update-interval | как часто обновлять эти данные, а не сами значения |
| Пинг | задержку до сервера в миллисекундах, а не объём трафика или срок подписки |
Отдельно стоит Provider ID: он не передаёт данные о трафике напрямую, но открывает провайдеру доступ к собственной статистике использования подписок на его стороне — независимо от того, что показано пользователю через subscription-userinfo.
Главное
- subscription-userinfo передаёт четыре значения одной строкой: upload, download, total (все в байтах) и expire (unix-время окончания).
- Happ складывает upload и download в одно число израсходованного трафика и показывает его рядом с total через знак «/».
- Значение expire — это дата окончания подписки в формате unix-время, то есть число секунд с 1 января 1970 года.
- Параметр передаётся HTTP-заголовком ответа сервера подписки или строкой с # перед списком конфигураций — оба способа равнозначны.
- Если total равен нулю, это обычно означает безлимитный трафик, а не то, что лимит уже исчерпан — точное поведение зависит от того, как провайдер формирует эту строку.
Частые вопросы
Что означают значения upload, download и total в subscription-userinfo?
upload и download — это раздельно исходящий и входящий трафик, который провайдер засчитал использованным, оба в байтах. total — общий лимит трафика на подписку, тоже в байтах. Happ складывает upload и download в одно число и показывает его в строке состояния подписки рядом с total, разделяя их знаком «/».
В каком формате указывается дата окончания подписки в параметре expire?
В формате unix-время — количестве секунд, прошедших с 1 января 1970 года по UTC. Это стандартный способ хранить дату и время в вычислительных системах: приложение переводит такое число в обычную календарную дату и показывает пользователю в строке состояния подписки, а не оставляет его в виде числа.
Что если провайдер не передал subscription-userinfo вообще?
Тогда Happ не покажет строку с трафиком и сроком действия для этой подписки — само подключение к серверам это не затрагивает, ограничение трафика и его отображение обеспечивает провайдер отдельно от базовой работы протокола. Список серверов и подключение к ним работают независимо от наличия этого параметра.
Как часто обновляются данные о трафике из subscription-userinfo?
Ровно так же, как остальные параметры подписки: при каждом ручном или автоматическом обновлении Happ заново запрашивает ответ сервера подписки и получает актуальную строку subscription-userinfo. Если провайдер обновляет счётчик трафика на своей стороне реже, старые цифры сохранятся в приложении до следующего успешного обновления.
Можно ли по subscription-userinfo узнать скорость подключения или текущую нагрузку на сервер?
Нет, этот параметр описывает только накопленный объём трафика и срок действия подписки в целом, а не текущую скорость или состояние конкретного сервера в моменте. Для проверки задержки до сервера в Happ есть отдельная функция пинга, а скорость соединения параметр subscription-userinfo не измеряет вообще.
Что означает total равный нулю в строке subscription-userinfo?
Обычно это способ провайдера показать, что лимит трафика не установлен, то есть подписка безлимитная по объёму данных. Но однозначного стандарта на этот счёт документация Happ не описывает, и разные провайдеры могут использовать нулевое значение по-разному — при сомнениях лучше уточнить у своего провайдера, как читать конкретно его цифры.
Упомянутые темы
Похожие материалы
Разделы по теме
Источники
- Документация Happ: управление приложением через подписку — обращение 28 сентября 2026
- Документация Happ: пинг — обращение 28 сентября 2026