Telegram Mini Apps: учебный план
Разберём mini app «Учебный план» на общей модели четырёх курсов. Сначала создадим полный читающий экран без сборщика, затем отделим функции Telegram от собственного сервера, подтверждённый план от черновика и отправку запроса от известного результата.
Нужны основы HTML, CSS и JavaScript. Серверные функции рассчитаны на семейство Node.js 24. Исполнение программ, браузера, SDK, бота, запросов, хранения и развёртывания не проводилось; приведённые результаты ожидаемые.
Экран и окружение
- Модель Telegram Mini App
- Первый экран мини-приложения
- SDK и объект WebApp
- Тема и цвета Telegram
- Размер и безопасная область
- Основная кнопка действия
- Возврат между экранами
Запуск, сервер и данные
- Данные запуска приложения
- Проверка initData на сервере
- Сессия мини-приложения
- Запросы к собственному API
- Форма внутри WebView
- Состояние между открытиями
- Хранение пользовательских настроек
Ссылки, отказ и выпуск
- Ссылки на сценарии приложения
- Передача результата пользователем
- Потеря сети в мини-приложении
- Различия клиентов Telegram
- Доступность интерфейса WebView
- Выпуск учебного мини-приложения
Учебные материалы
Скачать материалы серии. В архиве находятся полные start/after читающего frontend 02–05, самостоятельные полные модули 06–19, две серверные функции, STATE каждого урока и редакционные договоры API/сессий/идемпотентности/выпуска.
Это учебный пакет, а не готовый серверный сервис. Настоящий бот и Main Mini App, HTTPS-адрес, HTTP-адаптер, постоянная база, транзакция записи и общий контроллер не поставляются. Наличие HMAC-функции не запускает личное сохранение. Клиентские и серверные файлы разделены; токен бота остаётся только на сервере при будущей интеграции.