Уведомления о голах быстрее, чем у конкурентов: как сделать мгновенные 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 всё равно останавливают фоновые запросы, чтобы беречь батарею. Уведомления о голе в закрытом приложении так не сделать.
Правильная схема:
- Сервер опрашивает API. Один запрос
eventsвозвращает все live-матчи вида спорта со счётом, минутой и периодом, неважно, идёт 50 матчей или 400. - Сервер помнит прошлый счёт каждого матча и сравнивает с ним новый
score_full. - Пользователь в приложении нажимает «следить за командой», и телефон подписывается на тему Firebase
team_<ID команды>. - Когда счёт изменился, сервер отправляет одно сообщение на темы обеих команд. Дальше 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 по умолчанию показывают уведомления с телефона. Отдельное приложение для часов не нужно. Нужен короткий заголовок: на экране часов помещается мало текста, поэтому команда и минута стоят в заголовке, а счёт в тексте.
Как проверить, что ваши уведомления быстрее
Фраза «быстрее конкурентов» ничего не стоит без замера. Проверить её можно за один вечер с топ-матчами:
- Поставьте на один телефон своё приложение и приложение, с которым сравниваете.
- Подпишитесь в обоих на команды, которые играют сегодня.
- Записывайте время каждого уведомления о голе в обоих приложениях — достаточно скриншотов шторки уведомлений.
- Наберите хотя бы 15–20 голов в разных лигах и сравните среднюю разницу.
Если ваши уведомления опаздывают, ищите причину по таблице из начала статьи: в логах сервера видно, когда изменился счёт в ответе API и когда ушло сообщение в Firebase.
Ошибки, из-за которых уведомления опаздывают или приходят лишние
- Опрос API с телефонов. Ключ становится общедоступным, а фоновые запросы останавливает система.
- Запрос
eventпо каждому матчу. Сотни запросов вместо одного, а счёт свежее не становится. - Без прогрева после перезапуска. Пользователи получают уведомления о старых голах.
- Подсобытия как отдельные матчи. Угловые и карточки превращаются в «голы».
- Подписка на
game_id. Матч переходит из prematch в live с новым ID, и подписка теряется. - Рассылка по каждому токену в цикле. На больших аудиториях последние пользователи получают уведомление позже первых. Темы Firebase решают это на стороне Google.
- Разбор счёта футбольным правилом во всех видах спорта. Формат счёта зависит от вида спорта. Для хоккея (
sport_id2) схема та же, но формат счёта и овертайм стоит проверить на тестовом ключе. Для баскетбола уведомления о каждом очке бессмысленны — там лучше слать итог четверти.
Как собрать уведомления о голах на 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. За два вечера с матчами можно запустить сервер из статьи и проверить, как быстро приходят уведомления.
Что сделать сегодня
- Получите тестовый ключ SportAPI.
- Создайте проект в Firebase и подключите к нему тестовое приложение.
- Запустите сервер из статьи на вечерних матчах и подпишитесь на пару команд.
- Сравните время уведомлений со своим текущим приложением.
Напишите менеджеру SportAPI в Telegram, что вы делаете приложение с уведомлениями о голах, — вы получите тестовый ключ к live-счёту и линии SportAPI и проверите скорость на реальных матчах.