Назад в блог

Что такое API для push-уведомлений и когда он нужен?

Что такое API для push-уведомлений и когда он нужен?

API для push-уведомлений — это веб-сервис, который выводит сообщение на экран блокировки телефона, когда ваш код об этом попросит. Вы отправляете один HTTP-запрос с заголовком и текстом, сервис передаёт его Apple или Google, и телефон показывает уведомление в течение нескольких секунд, даже если ни одно приложение не открыто.

Это и есть вся идея. Детали зависят от того, для кого предназначено уведомление и сколько звеньев доставки вы хотите контролировать самостоятельно.

Два разных понятия с одним названием

Если искать «push notification API», вы найдёте два типа продуктов, которые почти не пересекаются.

Платформы, которые отправляют push вашим пользователям. Firebase Cloud Messaging, Apple Push Notification service, OneSignal и похожие. Вы создаёте мобильное приложение, публикуете его в App Store и Google Play, собираете токен устройства с каждой установки и отправляете продуктовые или маркетинговые уведомления тысячам людей. API здесь — последний шаг долгого проекта.

Сервисы, которые отправляют push вам. Pocket Alert, Pushover, ntfy и другие. Приложение уже существует: вы устанавливаете его на свой телефон, получаете API-ключ и отправляете оповещения из скриптов, серверов и других сервисов. Ничего публиковать не нужно, токены собирать не нужно. Деплой завершился, бэкап упал, пришёл платёж.

Это руководство о втором типе. Если вы создаёте потребительское приложение и хотите достучаться до его пользователей, нужен первый тип, и большая часть дальнейшего вам не пригодится.

Что происходит, когда вы отправляете запрос

Четыре этапа, и большинство из них незаметны:

  1. Ваш код отправляет HTTPS-запрос в сервис с заголовком, текстом сообщения и вашим API-ключом.
  2. Сервис проверяет ключ, сохраняет сообщение и решает, куда его отправить: на какие ваши устройства и с каким приоритетом.
  3. Он передаёт уведомление в собственную push-сеть платформы: APNs для iPhone и Firebase Cloud Messaging для Android.
  4. Apple или Google доставляют его по соединению, которое телефон и так постоянно держит с ними, и телефон показывает уведомление.

Последние два этапа объясняют, почему push работает при закрытом приложении и не разряжает батарею: телефон никого не опрашивает. Полный путь описан в статье Как работают push-уведомления: APNs и FCM.

Почему не работать с Apple и Google напрямую?

Можно, если у вас есть собственное приложение в обоих магазинах. Чтобы отправлять push на собственный телефон без посредников, понадобится:

  • Членство в Apple Developer Program и iOS-приложение с включённым push-entitlement, а также проект Firebase и Android-приложение для второй платформы.
  • Ключ подписи APNs и сервисный аккаунт Firebase, а также код, который подписывает запросы для каждой из них.
  • Способ собирать токены устройств из приложения и обновлять их при изменении.
  • Два формата запросов, две модели приоритетов и два набора кодов ошибок.

Для продукта, который и есть ваше приложение, это разумный проект. Но для «сообщи мне, когда упадёт cron-задача» это слишком много механики. Сервис push-уведомлений сделал всё это один раз для всех.

Как выглядит запрос

С Pocket Alert отправка уведомления — это один авторизованный POST-запрос:

curl -X POST https://api.pocketalert.app/v1/messages \
  -H 'Token: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"title": "Deploy finished", "message": "api v2.4.1 is live"}'

Ответ — 201 Created с сохранённым сообщением и приоритетом, с которым оно ушло. Тот же запрос работает из любого языка с HTTP-клиентом, а в статье Отправка push-уведомлений через curl больше примеров для терминала.

Обязательны только title и message. Необязательные поля, которые важнее всего для оповещений:

  • level задаёт, насколько громко уведомление придёт: silent, low, default, high или critical.
  • actions добавляет до трёх кнопок действий: открыть URL, выполнить HTTP-запрос или скопировать значение.
  • send_at или delay откладывает отправку (на платных тарифах).
  • application_id и device_id указывают, к какому проекту относится сообщение и какой телефон его получит.

Три способа отправки, а не только API

API для push-уведомлений полезнее всего тогда, когда не нужно писать код для каждого источника.

  • HTTP API для ваших скриптов, задач и приложений.
  • URL вебхуков для сервисов, которые уже умеют отправлять вебхуки. GitHub, Stripe, Grafana или Sentry присылают свой JSON на вебхук Pocket Alert, а плейсхолдеры вроде %repository.name% вытаскивают из него поля в уведомление без единой строки кода. Пошагово это описано в статье Создайте первый URL вебхука.
  • CLI и MCP-сервер для терминала и AI-агентов: pocketalert send "Build done" "All tests passed" из командной строки (CLI) или инструмент create_message, который Claude или Cursor вызывает по окончании длинной задачи (MCP).

Где это пригодится

Большинство оповещений укладывается в несколько групп:

Общее у всех этих случаев — событие, о котором человеку нужно знать сейчас, а не при следующем открытии панели или почты.

На что смотреть перед выбором

Каждый сервис в этой нише отправляет push по HTTP-запросу. Различия — во всём остальном:

  • Платформы. Некоторые работают только на iPhone (Bark, The Notification App), а единственное официальное приложение Gotify — для Android. Если кому-то, кому нужно оповещение, пользуется другим телефоном, это решает вопрос.
  • Уровни приоритета. Может ли упавший бэкап звучать иначе, чем новая регистрация? Может ли критичное оповещение пройти через режим «Не беспокоить»?
  • Входящие вебхуки. Может ли сервис отправлять собственный JSON или каждому источнику нужен скрипт, который его перестраивает?
  • История и логи. Если оповещение не пришло, есть ли запись о вызове и о том, что с ним произошло?
  • Лимиты и цены. В день, в месяц или навсегда, и что происходит при достижении лимита.
  • Кто это запускает. Хостируемый сервис или сервер, который вы поддерживаете сами.

Мы сравниваем Pocket Alert с Pushover, ntfy, Pushbullet, Bark, Gotify и другими именно по этим пунктам на странице Альтернативы, в том числе указываем, где каждый из них — лучший выбор.

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

API для push-уведомлений — это то же самое, что Firebase Cloud Messaging?

FCM — один из API для push-уведомлений: тот, который Google предоставляет для приложений, которые вы создаёте и публикуете. Такие сервисы, как Pocket Alert, работают поверх FCM и APNs и берут на себя приложение, ключи и токены устройств, так что вам остаётся только сделать HTTP-запрос.

Нужно ли создавать мобильное приложение?

Для оповещений себе или команде — нет. Вы устанавливаете готовое приложение, например Pocket Alert для iPhone или Android, и отправляете уведомления в него. Собственное приложение нужно только для отправки push вашим пользователям.

Это бесплатно?

Многие сервисы предлагают бесплатный тариф. У Pocket Alert он даёт 50 сообщений в день без привязки карты, чего хватает для большинства личных оповещений, а платные тарифы стартуют с $6 в месяц за 1 000 сообщений в день. Подробности на странице тарифов.

Насколько быстро доходит уведомление?

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

Push, SMS или email?

Push — для того, что требует внимания прямо сейчас, email — для сводок и записей, SMS — когда у человека нет смартфона с приложением вообще. Компромиссы описаны в статьях Push-уведомления и SMS и Push-уведомления и email-оповещения.

Создайте бесплатный аккаунт, скопируйте API-ключ, и команда curl выше станет вашим первым push-уведомлением.

Поделиться статьёй