Перейти к содержанию

Управление через заголовки

HTTP-заголовки позволяют провайдеру передавать информацию о подписке прямо в интерфейс Mole. Все заголовки опциональны — подписка без единого из них импортируется нормально.

Статистика пользователя

Используется стандартный заголовок subscription-userinfo:

subscription-userinfo: upload=1073741824; download=5368709120; total=107374182400; expire=1722612000
  • upload / download: Использованный трафик в байтах.
  • total: Общий лимит в байтах.
  • expire: Unix timestamp окончания подписки (в секундах).

Поддерживаемые заголовки

Заголовок Действие в приложении
subscription-userinfo Трафик и срок действия в блоке подписки
profile-title Имя подписки
announce Текст уведомления в блоке подписки
support-url Адрес для действия «Поддержка»
profile-web-page-url Ссылка на личный кабинет
profile-update-interval Рекомендуемый интервал обновления, в часах
profile-update-always true — включить автообновление подписки

profile-title

Задаёт отображаемое имя. Если пользователь переименовал подписку вручную в её настройках, введённое им имя закрепляется и profile-title его больше не перезаписывает.

announce

Текст выводится внутри блока подписки на экране «Серверы». Это не push-уведомление: сообщение появляется после очередного обновления подписки, а не в произвольный момент.

Заголовок должен содержать только ASCII (ограничение HTTP). Для кириллицы кодируйте значение в base64 или percent-encoding — Mole декодирует оба варианта.

profile-update-interval

Значение в часах. Mole использует его двояко:

  • 0 выключает автообновление, любое положительное значение включает;
  • пока пользователь не задал собственный интервал в настройках подписки, ваше значение подставляется как рекомендуемое (округляется до ближайшего из пресетов 30 мин / 1 / 2 / 6 / 12 / 24 ч).

Пользовательский интервал имеет приоритет и вашим значением не перезаписывается.

Чего Mole не читает

Заголовки вида profile-icon, banner-image или hide-url в Mole не реализованы и игнорируются.