SportAPI
Live-интерфейсы

Приложение с live-результатами на Flutter: от API до публикации в сторе

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

Смартфоны с приложением live-результатов, собранным на Flutter

Приложение с 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

  1. Иконка, название и скриншоты — покажите экран Live с реальными матчами.
  2. Политика конфиденциальности — нужна обоим магазинам, даже если вы не собираете личные данные.
  3. Сборка: flutter build appbundle для Google Play и flutter build ipa для App Store (на macOS с Xcode).
  4. Категория и возрастной рейтинг — для приложения результатов это «Спорт». Если показываете коэффициенты или принимаете ставки, изучите отдельные правила магазинов для таких приложений: приложению только с результатами пройти проверку проще.
  5. Тестирование — выпустите закрытую бета-версию и проверьте приложение во время реальных матчей.

Пет-проект или заказ

Для портфолио такое приложение показывает всё, что ценят заказчики: работу с внешним 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 и посмотреть, как приложение работает во время матчей.

Что сделать сегодня

  1. Получите тестовый ключ SportAPI.
  2. Создайте проект Flutter и вставьте код экрана Live.
  3. Запустите приложение во время матчей и проверьте обновление.
  4. Добавьте экран матча со статистикой и расписание на день.
  5. Перед публикацией вынесите ключ на свой сервер с кешем.

Напишите менеджеру SportAPI в Telegram, какие виды спорта нужны вашему приложению, — вы получите тестовый ключ к API спортивной линии и коэффициентов и соберёте первый экран за вечер.

← Все статьи