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

> API для push-уведомлений превращает один HTTP-запрос в уведомление на телефоне. Разбираем, что он делает, какие два типа продуктов носят это название, как выглядит запрос и на что смотреть перед выбором.

*04.10.2026*

<!-- source: https://pocketalert.app/ru/blog/what-is-a-push-notification-api -->

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](/blog/how-push-notifications-work-apns-fcm).

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

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

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

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

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

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

```bash
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](/use-cases/curl-push-notifications) больше примеров для терминала.

Обязательны только `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 вебхука](/blog/create-your-first-webhook-url).
- **CLI и MCP-сервер** для терминала и AI-агентов: `pocketalert send "Build done" "All tests passed"` из командной строки ([CLI](/tools/cli)) или инструмент `create_message`, который Claude или Cursor вызывает по окончании длинной задачи ([MCP](/tools/mcp)).

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

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

- **Что-то сломалось.** Сервер перестал отвечать, cron-задача завершилась с ошибкой, бэкап не выполнился. См. [оповещения о cron-задачах](/use-cases/cron-job-alerts) и [мониторинг серверов](/use-cases/server-monitoring).
- **Что-то завершилось.** Деплой, долгая сборка, 12-часовая печать на 3D-принтере, задача AI-агента. См. [оповещения о деплое](/use-cases/deployment-alerts).
- **Произошло событие, которое важно.** Платёж, регистрация, отправка формы. См. [оповещения о платежах](/use-cases/payment-alerts) и [оповещения о регистрации](/use-cases/signup-alerts).
- **Скоро произойдёт.** Сертификат истекает через 14 дней. См. [оповещения об истечении SSL-сертификата](/use-cases/ssl-expiration-alerts).

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

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

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

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

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

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

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

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

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

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

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

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

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

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

### Push, SMS или email?

Push — для того, что требует внимания прямо сейчас, email — для сводок и записей, SMS — когда у человека нет смартфона с приложением вообще. Компромиссы описаны в статьях [Push-уведомления и SMS](/blog/push-notifications-vs-sms) и [Push-уведомления и email-оповещения](/blog/push-vs-email-alerts).

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