Что такое 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-ключ и отправляете оповещения из скриптов, серверов и других сервисов. Ничего публиковать не нужно, токены собирать не нужно. Деплой завершился, бэкап упал, пришёл платёж.
Это руководство о втором типе. Если вы создаёте потребительское приложение и хотите достучаться до его пользователей, нужен первый тип, и большая часть дальнейшего вам не пригодится.
Что происходит, когда вы отправляете запрос
Четыре этапа, и большинство из них незаметны:
- Ваш код отправляет HTTPS-запрос в сервис с заголовком, текстом сообщения и вашим API-ключом.
- Сервис проверяет ключ, сохраняет сообщение и решает, куда его отправить: на какие ваши устройства и с каким приоритетом.
- Он передаёт уведомление в собственную push-сеть платформы: APNs для iPhone и Firebase Cloud Messaging для Android.
- 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).
Где это пригодится
Большинство оповещений укладывается в несколько групп:
- Что-то сломалось. Сервер перестал отвечать, cron-задача завершилась с ошибкой, бэкап не выполнился. См. оповещения о cron-задачах и мониторинг серверов.
- Что-то завершилось. Деплой, долгая сборка, 12-часовая печать на 3D-принтере, задача AI-агента. См. оповещения о деплое.
- Произошло событие, которое важно. Платёж, регистрация, отправка формы. См. оповещения о платежах и оповещения о регистрации.
- Скоро произойдёт. Сертификат истекает через 14 дней. См. оповещения об истечении SSL-сертификата.
Общее у всех этих случаев — событие, о котором человеку нужно знать сейчас, а не при следующем открытии панели или почты.
На что смотреть перед выбором
Каждый сервис в этой нише отправляет 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-уведомлением.