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

Уведомления о голах быстрее, чем у конкурентов: как сделать мгновенные push

Как устроены приложения с уведомлениями о голах, откуда берётся задержка и как собрать свои push-уведомления на Android и iPhone: сервер, live-счёт из API и Firebase.

Смартфон и умные часы со всплывающим уведомлением о голе на фоне футбольного стадиона

Уведомление о голе состоит из трёх шагов: сервер узнаёт, что изменился счёт, находит тех, кто подписан на команду, и отправляет push через Google и Apple. Опаздывает обычно не телефон, а первый шаг: сервер слишком редко спрашивает источник о счёте или проверяет каждый матч отдельным запросом.

Ниже схема, по которой можно собрать своё приложение с уведомлениями о голах. Live-счёт всех футбольных матчей приходит из API спортивной линии SportAPI одним запросом раз в 7 секунд, сервер сравнивает счёт с предыдущим и рассылает push через Firebase Cloud Messaging. Те же уведомления сами появляются на Apple Watch и часах с Wear OS. Данные стоят от $30 в месяц за вид спорта, проверить их можно на тестовом ключе за 2 дня.

Откуда берётся задержка уведомления о голе

Между голом на поле и вибрацией в кармане проходит несколько этапов. Поставщик данных на часть из них не влияет, зато на ваши этапы приходится основная задержка.

ЭтапОт чего зависитЧто можно сделать
Счёт меняется в APIИсточник данныхПроверить скорость на тестовом ключе на реальных матчах
Сервер узнаёт о голеКак часто вы спрашиваете APIОпрашивать live-список раз в 7 секунд — в среднем гол ждёт опроса около 3,5 секунды
Сервер решает, кому отправитьВаш кодОдин проход по всем матчам, без отдельного запроса на каждый матч
РассылкаКак вы отправляете pushТемы Firebase вместо рассылки по каждому устройству
Доставка на телефонGoogle, Apple, энергосбережение телефонаВысокий приоритет на Android, Time Sensitive на iPhone

Приложения, которые присылают гол через минуту, обычно теряют время на втором и четвёртом этапах: проверяют счёт раз в 30–60 секунд или рассылают уведомления по списку из миллиона токенов в одном цикле.

Схема: один сервер вместо опроса с каждого телефона

Первая мысль — пусть приложение само спрашивает API раз в несколько секунд. Так делать нельзя. Ключ API окажется в каждом установленном приложении, тысяча пользователей даст тысячу одинаковых запросов, а iOS и Android всё равно останавливают фоновые запросы, чтобы беречь батарею. Уведомления о голе в закрытом приложении так не сделать.

Правильная схема:

  1. Сервер опрашивает API. Один запрос events возвращает все live-матчи вида спорта со счётом, минутой и периодом, неважно, идёт 50 матчей или 400.
  2. Сервер помнит прошлый счёт каждого матча и сравнивает с ним новый score_full.
  3. Пользователь в приложении нажимает «следить за командой», и телефон подписывается на тему Firebase team_<ID команды>.
  4. Когда счёт изменился, сервер отправляет одно сообщение на темы обеих команд. Дальше Firebase сам доставляет его всем подписчикам на Android и iPhone.

Подписка на команду, а не на матч, нужна не только для удобства. В SportAPI у матча в prematch и в live разные game_id: когда матч начинается, он появляется в live под новым ID. Команды остаются теми же, поэтому подписку через opp_1_id и opp_2_id не нужно переносить. Как устроены ID матчей, описано в модели матча.

Как часто спрашивать API

В рекомендациях по обновлению данных указаны минимальные интервалы для live:

ЗапросЧто возвращаетИнтервал для live
eventsВсе live-матчи вида спорта со счётомне чаще раза в 7 секунд
eventОдин матч со всеми рынками и статистикойне чаще раза в 5 секунд
menuСписок турнировне чаще раза в 20 секунд

Для уведомлений о голах достаточно одного events раз в 7 секунд. Запрос event по каждому матчу ничего не ускорит и только нагрузит сервер. Если в приложении есть один главный матч дня, на который подписано больше всего людей, можно дополнительно спрашивать его через event раз в 5 секунд.

Новый запрос отправляйте только после того, как пришёл ответ на предыдущий. Если API вернул 429 Too many requests, подождите столько секунд, сколько указано в заголовке Retry-After.

Код сервера: ищем гол и отправляем push

Пример на Node.js 18+ с библиотекой firebase-admin. Ключ SportAPI и файл сервисного аккаунта Firebase хранятся в переменных окружения.

import admin from 'firebase-admin';

admin.initializeApp(); // учётные данные — из GOOGLE_APPLICATION_CREDENTIALS

const LIVE_URL = 'https://YOUR_API_DOMAIN/v1/events/1/0/sub/50/live/ru';
const POLL_MS = 7000;
const scores = new Map(); // game_id → { home, away, seenAt }
let warmedUp = false;

function parseScore(value) {
  const match = /^(\d+):(\d+)$/.exec(value || '');
  return match ? { home: Number(match[1]), away: Number(match[2]) } : null;
}

async function poll() {
  const res = await fetch(LIVE_URL, { headers: { Package: process.env.SPORTAPI_KEY } });
  if (res.status === 429) {
    return Number(res.headers.get('Retry-After') || 10) * 1000;
  }
  if (!res.ok) return POLL_MS;

  const data = await res.json();
  const now = Date.now();
  for (const tournament of data.body ?? []) {
    for (const game of tournament.events_list) {
      if (game.game_id !== game.game_mid || game.game_dop_name) continue; // угловые, карточки и другие подсобытия
      const score = parseScore(game.score_full);
      if (!score) continue;

      const prev = scores.get(game.game_id);
      scores.set(game.game_id, { ...score, seenAt: now });
      if (!warmedUp || !prev) continue; // первый раз видим матч — только запоминаем счёт

      if (score.home > prev.home) await sendGoal(game, score, game.opp_1_name);
      if (score.away > prev.away) await sendGoal(game, score, game.opp_2_name);
      if (score.home < prev.home || score.away < prev.away) await sendCorrection(game, score);
    }
  }

  for (const [id, item] of scores) {
    if (now - item.seenAt > 10 * 60 * 1000) scores.delete(id); // матч давно пропал из live
  }
  warmedUp = true;
  return POLL_MS;
}

async function loop() {
  let wait = POLL_MS;
  try {
    wait = await poll();
  } catch (err) {
    console.error(err);
  }
  setTimeout(loop, wait);
}

loop();

Функция отправки собирает текст и отправляет одно сообщение подписчикам обеих команд:

function fansOf(game) {
  return `'team_${game.opp_1_id}' in topics || 'team_${game.opp_2_id}' in topics`;
}

async function sendGoal(game, score, scorer) {
  const minute = Math.floor(game.timer / 60);
  await admin.messaging().send({
    condition: fansOf(game),
    notification: {
      title: `Гол! ${scorer}, ${minute}'`,
      body: `${game.opp_1_name} ${score.home}:${score.away} ${game.opp_2_name}`,
    },
    data: { game_id: String(game.game_id) },
    android: { priority: 'high', collapseKey: String(game.game_id) },
    apns: { payload: { aps: { 'interruption-level': 'time-sensitive' } } },
  });
}

async function sendCorrection(game, score) {
  await admin.messaging().send({
    condition: fansOf(game),
    notification: {
      title: 'Гол отменён',
      body: `${game.opp_1_name} ${score.home}:${score.away} ${game.opp_2_name}`,
    },
    data: { game_id: String(game.game_id) },
    android: { priority: 'high', collapseKey: String(game.game_id) },
  });
}

Несколько решений в коде, которые легко пропустить:

  • Прогрев после запуска. Первый проход только запоминает счёт. Без этого после перезапуска сервера пользователи получат пачку уведомлений о голах часовой давности.
  • Только основные матчи. Подсобытия вроде угловых и карточек имеют свой счёт. Фильтр по game_mid и game_dop_name не даёт отправить «гол», когда на самом деле подали угловой.
  • Отменённый гол. Счёт уменьшился, значит гол отменили после просмотра видео. Отдельное уведомление честнее, чем молча показать старый счёт.
  • collapseKey. На Android новое уведомление по матчу заменяет предыдущее, а не складывается в стопку.
  • Минута из timer. Поле приходит в секундах, поэтому делим на 60.

На стороне приложения подписка на команду — одна строка. Во Flutter она выглядит так, в нативных приложениях Android и iOS есть такой же метод в Firebase SDK:

await FirebaseMessaging.instance.subscribeToTopic('team_$teamId');

Как собрать само приложение со списком live-матчей, мы разбирали в статье про приложение live-результатов на Flutter.

Как дойти до телефона за секунды

Google и Apple не гарантируют время доставки, но несколько настроек сильно влияют на результат.

Android. Сообщения с priority: 'high' доставляются сразу, даже когда телефон в режиме энергосбережения. Обычный приоритет система может придержать до следующего пробуждения телефона. Высокий приоритет нужен только для сообщений, которые показывают уведомление: если срочные сообщения приходят без видимого уведомления, Firebase может понизить их приоритет. Голы подходят, тихие служебные сообщения — нет.

iPhone. Уровень time-sensitive показывает уведомление даже в режиме фокусировки, если пользователь это разрешил. Для этого в проекте Xcode нужно включить возможность Time Sensitive Notifications.

Часы. На Apple Watch уведомления iPhone приходят автоматически, когда телефон заблокирован, а часы на руке. Часы с Wear OS по умолчанию показывают уведомления с телефона. Отдельное приложение для часов не нужно. Нужен короткий заголовок: на экране часов помещается мало текста, поэтому команда и минута стоят в заголовке, а счёт в тексте.

Как проверить, что ваши уведомления быстрее

Фраза «быстрее конкурентов» ничего не стоит без замера. Проверить её можно за один вечер с топ-матчами:

  1. Поставьте на один телефон своё приложение и приложение, с которым сравниваете.
  2. Подпишитесь в обоих на команды, которые играют сегодня.
  3. Записывайте время каждого уведомления о голе в обоих приложениях — достаточно скриншотов шторки уведомлений.
  4. Наберите хотя бы 15–20 голов в разных лигах и сравните среднюю разницу.

Если ваши уведомления опаздывают, ищите причину по таблице из начала статьи: в логах сервера видно, когда изменился счёт в ответе API и когда ушло сообщение в Firebase.

Ошибки, из-за которых уведомления опаздывают или приходят лишние

  • Опрос API с телефонов. Ключ становится общедоступным, а фоновые запросы останавливает система.
  • Запрос event по каждому матчу. Сотни запросов вместо одного, а счёт свежее не становится.
  • Без прогрева после перезапуска. Пользователи получают уведомления о старых голах.
  • Подсобытия как отдельные матчи. Угловые и карточки превращаются в «голы».
  • Подписка на game_id. Матч переходит из prematch в live с новым ID, и подписка теряется.
  • Рассылка по каждому токену в цикле. На больших аудиториях последние пользователи получают уведомление позже первых. Темы Firebase решают это на стороне Google.
  • Разбор счёта футбольным правилом во всех видах спорта. Формат счёта зависит от вида спорта. Для хоккея (sport_id 2) схема та же, но формат счёта и овертайм стоит проверить на тестовом ключе. Для баскетбола уведомления о каждом очке бессмысленны — там лучше слать итог четверти.

Как собрать уведомления о голах на SportAPI

Со стороны данных приложению с уведомлениями о голах нужно немного, и всё это есть в SportAPI:

  • live-счёт score_full, период period_name и время матча timer для всех live-матчей вида спорта одним запросом;
  • ID команд opp_1_id и opp_2_id для подписок и логотипы команд для красивых уведомлений;
  • prematch-линия и календарь матчей, чтобы показать в приложении расписание и дать подписаться на команду заранее;
  • безлимит запросов в рамках рекомендованных интервалов — нет месячного лимита, который закончится в разгар тура.

Чего нет: WebSocket. Данные передаются по REST, подключение через WebSocket в разработке, поэтому сервер узнаёт о голе при очередном опросе.

Если вы хотите получать сигналы не только о голах, а по своим условиям — счёт, минута, статистика, коэффициенты — посмотрите статью про бота live-сигналов.

Сколько стоит

Что нужноСтоимость
Live-счёт и линия одного вида спорта — например, футболаот $30 в месяц
Каждый дополнительный вид спорта — например, хоккейот $30 в месяц
Firebase Cloud Messagingбесплатно, по данным Firebase на октябрь 2026
Проверка до оплатыТестовый ключ SportAPI на 2 дня, все виды спорта

Частые вопросы

Почему в одних приложениях гол приходит сразу, а в других через минуту?

Чаще всего дело в сервере приложения: как часто он проверяет счёт и как рассылает уведомления. Проверка раз в минуту или рассылка по одному устройству за раз добавляют десятки секунд. Сам Firebase обычно не главная причина.

Можно ли получать уведомления о голах на Apple Watch?

Да. Уведомления с iPhone автоматически показываются на Apple Watch, когда телефон заблокирован. Отдельное приложение для часов не требуется — достаточно короткого заголовка, который помещается на экран.

Как часто можно запрашивать live-счёт?

Список live-матчей events — не чаще раза в 7 секунд, один матч event — не чаще раза в 5 секунд. Если менеджер SportAPI выдал для вашего подключения другие интервалы, используйте их.

Нужен ли свой сервер, или можно обойтись приложением?

Нужен. Без сервера ключ API окажется внутри приложения, а уведомления не придут, когда приложение закрыто. Для сервера хватит небольшой виртуальной машины: один запрос раз в 7 секунд и рассылка через Firebase.

Подойдёт ли это для хоккея и других видов спорта?

Да, схема одна: другой sport_id в запросе. Формат счёта отличается по видам спорта, поэтому разбор счёта для каждого вида спорта проверьте на тестовом ключе.

Можно ли проверить до оплаты?

Да. Тестовый ключ на 2 дня включает все виды спорта и live. За два вечера с матчами можно запустить сервер из статьи и проверить, как быстро приходят уведомления.

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

  1. Получите тестовый ключ SportAPI.
  2. Создайте проект в Firebase и подключите к нему тестовое приложение.
  3. Запустите сервер из статьи на вечерних матчах и подпишитесь на пару команд.
  4. Сравните время уведомлений со своим текущим приложением.

Напишите менеджеру SportAPI в Telegram, что вы делаете приложение с уведомлениями о голах, — вы получите тестовый ключ к live-счёту и линии SportAPI и проверите скорость на реальных матчах.

← Все статьи