Приложение с live-результатами на Flutter: от API до публикации в сторе
Пошагово: приложение с live-счётом матчей на Flutter для Android и iOS — данные из SportAPI, экран live, автообновление, свой сервер для ключа и публикация в магазинах приложений.

Приложение с live-результатами — отличный пет-проект и частый заказ на фрилансе: понятная задача, живые данные и сразу две платформы. На Flutter один код работает и на Android, и на iOS, а данные — live-счёт, время матча, статистику, расписание и коэффициенты — даёт API спортивной линии SportAPI: от $30 в месяц за вид спорта, с тестовым доступом на 2 дня. Ниже — путь от первого запроса к API до публикации в магазинах приложений, с рабочим кодом экрана live-матчей.
Что будет в приложении
| Экран | Что показывает | Данные SportAPI |
|---|---|---|
| Live | Матчи, которые идут сейчас: счёт, минута, турнир | events с типом live |
| Сегодня | Расписание матчей на день | Календарь матчей |
| Матч | Счёт, период, статистика: атаки, удары, угловые, карточки | event, поле stat_list |
| Избранное | Любимые команды и уведомления о голах | Live-матчи + ваш сервер |
Для первой версии достаточно одного экрана Live — с него и начнём.
Архитектура: зачем свой сервер между приложением и API
Мобильное приложение нельзя считать надёжным хранилищем секретов: ключ API, зашитый в сборку, можно извлечь. Поэтому в рабочей версии приложение ходит не в SportAPI напрямую, а на ваш небольшой сервер:
SportAPI → ваш сервер (ключ, кеш 7–15 секунд) → приложение у тысяч пользователей
У такого сервера три задачи:
- Хранит ключ. Ключ SportAPI не попадает в приложение.
- Кеширует. Сервер запрашивает live-матчи раз в 7–15 секунд и раздаёт один ответ всем пользователям — нагрузка на API не растёт вместе с аудиторией. Рекомендуемые интервалы обновления описаны в документации.
- Отправляет уведомления. Сравнивает счёт между запросами и шлёт push о голе тем, кто подписан на команду.
Для прототипа можно ходить в API напрямую, как в коде ниже, но перед публикацией замените адрес на свой сервер.
Шаг 1. Создайте проект
flutter create live_scores
cd live_scores
flutter pub add http
Шаг 2. Экран live-матчей
Весь экран — один файл lib/main.dart: модель матча, разбор ответа API, запрос и список с автообновлением раз в 15 секунд и обновлением жестом «потянуть вниз».
import 'dart:async';
import 'dart:convert';
import 'package:flutter/material.dart';
import 'package:http/http.dart' as http;
// В рабочем приложении запрос идёт на ваш сервер, а не напрямую в SportAPI
const apiBase = 'https://YOUR_API_DOMAIN/v1';
const apiKey = String.fromEnvironment('SPORTAPI_KEY');
class LiveMatch {
const LiveMatch({
required this.tournament,
required this.home,
required this.away,
required this.score,
required this.minute,
});
final String tournament;
final String home;
final String away;
final String score;
final int minute;
}
List<LiveMatch> parseLive(String json) {
final body = jsonDecode(json)['body'] as List;
return [
for (final tournament in body)
for (final match in tournament['events_list'] as List)
LiveMatch(
tournament: tournament['tournament_name'] as String,
home: match['opp_1_name'] as String,
away: match['opp_2_name'] as String,
score: (match['score_full'] ?? '') as String,
minute: ((match['timer'] ?? 0) as int) ~/ 60,
),
];
}
Future<List<LiveMatch>> fetchLive({int sportId = 1}) async {
final response = await http.get(
Uri.parse('$apiBase/events/$sportId/0/sub/50/live/ru'),
headers: {'Package': apiKey},
);
if (response.statusCode != 200) {
throw Exception('HTTP ${response.statusCode}');
}
return parseLive(utf8.decode(response.bodyBytes));
}
class LiveScreen extends StatefulWidget {
const LiveScreen({super.key});
@override
State<LiveScreen> createState() => _LiveScreenState();
}
class _LiveScreenState extends State<LiveScreen> {
List<LiveMatch> matches = [];
Timer? timer;
@override
void initState() {
super.initState();
refresh();
timer = Timer.periodic(const Duration(seconds: 15), (_) => refresh());
}
Future<void> refresh() async {
try {
final data = await fetchLive();
if (mounted) setState(() => matches = data);
} catch (_) {
// нет сети — оставляем прошлые данные и пробуем снова через 15 секунд
}
}
@override
void dispose() {
timer?.cancel();
super.dispose();
}
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(title: const Text('Live')),
body: RefreshIndicator(
onRefresh: refresh,
child: ListView.builder(
itemCount: matches.length,
itemBuilder: (context, index) {
final match = matches[index];
return ListTile(
title: Text('${match.home} — ${match.away}'),
subtitle: Text(match.tournament),
trailing: Text("${match.score} ${match.minute}'"),
);
},
),
),
);
}
}
void main() => runApp(const MaterialApp(home: LiveScreen()));
Код проверен flutter analyze, а функция parseLive — тестом на реальном live-ответе из документации SportAPI. Для прототипа ключ передаётся при сборке: flutter run --dart-define=SPORTAPI_KEY=ваш-ключ. Ответ декодируется через utf8.decode, чтобы названия команд на любом языке отображались корректно.
Шаг 3. Экран матча и статистика
По нажатию на матч откройте экран с подробностями. Метод event возвращает все рынки матча, а в live — ещё и stat_list: атаки, опасные атаки, удары в створ, угловые, карточки, xG. Каждый показатель приходит с ID, названием и значениями для обеих команд, поэтому его удобно выводить полосками сравнения. Статистика есть не у всех live-матчей — показывайте блок только когда она пришла. Подробности — в документации live-статистики.
Шаг 4. Расписание и избранное
Экран «Сегодня» строится из календаря матчей: один запрос возвращает все матчи вида спорта до конца суток, топ-лиги — первыми. Избранное храните на устройстве, а подписки на уведомления — на своём сервере, который сравнивает счёт и отправляет push.
Шаг 5. Публикация в Google Play и App Store
- Иконка, название и скриншоты — покажите экран Live с реальными матчами.
- Политика конфиденциальности — нужна обоим магазинам, даже если вы не собираете личные данные.
- Сборка:
flutter build appbundleдля Google Play иflutter build ipaдля App Store (на macOS с Xcode). - Категория и возрастной рейтинг — для приложения результатов это «Спорт». Если показываете коэффициенты или принимаете ставки, изучите отдельные правила магазинов для таких приложений: приложению только с результатами пройти проверку проще.
- Тестирование — выпустите закрытую бета-версию и проверьте приложение во время реальных матчей.
Пет-проект или заказ
Для портфолио такое приложение показывает всё, что ценят заказчики: работу с внешним API, обновление данных в реальном времени, состояние экрана и публикацию в магазинах. А запросы вида «создать спортивное приложение» и «приложение результаты матчей» — частые заказы на фриланс-биржах: спортивные сайты, клубы и медиа хотят своё приложение. Готовый проект на реальных данных — сильный аргумент на собеседовании и в отклике на заказ.
Ошибки, которые встречаются чаще всего
- Ключ API в сборке приложения. Его можно извлечь — в рабочей версии используйте свой сервер.
- Запрос к API с каждого телефона. Без сервера-кеша тысяча пользователей — это тысяча одинаковых запросов.
- Нет обработки ошибок сети. В метро интернет пропадает — приложение должно показывать последние данные, а не пустой экран.
- Статистика у всех матчей. Её нет у части live-матчей — не показывайте пустые блоки.
- Слишком частое обновление. 15 секунд в приложении достаточно; чаще — лишний расход батареи и трафика.
Сколько стоит
| Что нужно | Стоимость |
|---|---|
| Live-счёт, расписание, статистика и коэффициенты по одному виду спорта | от $30 в месяц |
| Сервер-прокси | Недорогой сервер или облачная функция |
| Публикация | Регистрационные взносы Google Play и App Store |
| Проверка до оплаты | Тестовый ключ SportAPI на 2 дня, все виды спорта |
Частые вопросы
Можно ли сделать приложение результатов матчей без своего сервера?
Для прототипа — да, как в примере. Для публикации — нет: ключ API в приложении можно извлечь, а без кеша нагрузка растёт вместе с числом пользователей.
Почему Flutter?
Один код для Android и iOS, быстрая разработка интерфейса и горячая перезагрузка. Для приложения со списками и обновлением данных это оптимальный выбор.
Как часто обновлять live-счёт?
В приложении — раз в 15 секунд или по жесту «потянуть вниз». Сервер-прокси может обновлять данные чаще, по интервалам из документации SportAPI.
Какие виды спорта можно показать?
Любые из линии SportAPI — футбол, хоккей, теннис, баскетбол, киберспорт и другие. Каждый вид спорта подключается отдельно по тарифу.
Можно ли проверить до оплаты?
Да. Тестовый ключ на 2 дня включает все виды спорта, prematch и live — этого хватит, чтобы собрать экран Live и посмотреть, как приложение работает во время матчей.
Что сделать сегодня
- Получите тестовый ключ SportAPI.
- Создайте проект Flutter и вставьте код экрана Live.
- Запустите приложение во время матчей и проверьте обновление.
- Добавьте экран матча со статистикой и расписание на день.
- Перед публикацией вынесите ключ на свой сервер с кешем.
Напишите менеджеру SportAPI в Telegram, какие виды спорта нужны вашему приложению, — вы получите тестовый ключ к API спортивной линии и коэффициентов и соберёте первый экран за вечер.