🎉 Обновление MiniApp подписки v2.0 + API
✨ Основные изменения
🎁 Промоакции и промокоды
Реализована полноценная система промоакций и промокодов для пользователей:
- Промо-оферы: Добавлены модели
MiniAppPromoOffer,MiniAppPromoOfferClaimRequestиMiniAppPromoOfferClaimResponseдля отображения и активации специальных предложений - Промокоды: Новые схемы
MiniAppPromoCode,MiniAppPromoCodeActivationRequestиMiniAppPromoCodeActivationResponseпозволяют пользователям активировать промокоды прямо из приложения - Промо-группы: Расширены модели
MiniAppPromoGroupиMiniAppAutoPromoGroupLevelс поддержкой:- Детальных параметров скидок
- Гибких периодов действия
- Применимости к дополнительным услугам (аддонам)
👥 Реферальная система
Полностью переработана и расширена реферальная программа:
MiniAppReferralTerms— условия реферальной программыMiniAppReferralStats— статистика по рефераламMiniAppReferralRecentEarning— последние начисленияMiniAppReferralItemиMiniAppReferralList— управление списком рефераловMiniAppReferralInfo— объединённая информация о реферальной программе пользователя
📚 Контент и документация
Добавлена поддержка информационного контента:
- FAQ: Модели
MiniAppFaqItemиMiniAppFaqдля отображения частых вопросов - Юридические документы:
MiniAppRichTextDocumentиMiniAppLegalDocumentsдля пользовательских соглашений, политик конфиденциальности и других документов
📱 Управление устройствами
Расширены возможности работы с устройствами:
MiniAppDeviceRemovalRequest— запрос на удаление устройстваMiniAppDeviceRemovalResponse— подтверждение удаления
📊 Расширенный ответ о подписке
Модель MiniAppSubscriptionResponse теперь включает:
- ✅ Доступные промо-оферы (
promo_offers) - ✅ Активные промо-группы (
promo_group) - ✅ Автоматически назначаемые промо-уровни (
auto_assign_promo_groups) - ✅ Общую сумму расходов (
total_spent) - ✅ FAQ и юридические документы (
faq,legal_documents) - ✅ Полную реферальную информацию (
referral_info)
🚀 Преимущества обновления
- Монетизация: Гибкая система скидок и промоакций для увеличения конверсии
- Вовлечённость: Реферальная программа стимулирует пользователей привлекать друзей
- Прозрачность: FAQ и юридические документы доступны прямо в приложении
- Аналитика: Детальная статистика по расходам, транзакциям и рефералам
- UX: Все промо-механики интегрированы в единый интерфейс Telegram MiniApp
📝 Технические детали
Изменённые файлы:
app/webapi/schemas/miniapp.py— добавлено 15+ новых моделей данных
Обратная совместимость: ✅ Сохранена