# Отправляйте push-уведомления с вашего бэкенда.

> Отправляйте push-уведомления из бэкенда через API Pocket Alert. Один авторизованный HTTP POST из Node, Python, PHP или Go — и уведомление на вашем телефоне за секунду.

<!-- source: https://pocketalert.app/ru/use-cases/api-alerts -->

Обновлено: 2026-08-11

API Pocket Alert отправляет push-уведомление на ваш телефон одним аутентифицированным HTTP POST-запросом. Вызывайте его из Node, Python, PHP или Go, передавайте заголовок, текст и уровень приоритета, и уведомление почти мгновенно появится на iPhone или Android.

## Три шага до первого push-уведомления через API

1. **Получите API-ключ** — Создайте API-ключ на странице API Keys и сохраните его в переменной окружения.
2. **Отправьте запрос** — Отправьте JSON с title и message на эндпоинт сообщений, передав ключ в заголовке Token.
3. **Запустите в работу** — Телефон завибрирует меньше чем через секунду. По мере роста потребностей добавляйте маршрутизацию по приложению и устройству.

## Push-уведомления в один запрос

Этот API лежит в основе каждого уведомления Pocket Alert. Подключите его к бэкенду одним запросом.

- **Простой REST, без SDK** — Один аутентифицированный POST-запрос отправляет push из HTTP-клиента, который вы уже используете. Ни SDK, ни очередей, ни брокеров не нужно.
- **Любой язык** — Node, Python, PHP, Go и Ruby могут отправлять push-уведомления Pocket Alert.
- **Аутентификация по ключу** — API-ключ передаётся в заголовке Token по HTTPS. Создавайте, ограничивайте и перевыпускайте ключи по своему графику.
- **Полный контроль** — Маршрутизируйте уведомления через application_id и адресуйте одно устройство через device_id или опустите параметр, чтобы отправить на все устройства, — всё одним вызовом.
- **Доставка меньше секунды** — Push-уведомления попадают на ваш iPhone или Android менее чем за секунду, этого достаточно для оповещений с бэкенда в реальном времени.
- **CLI и вебхуки «из коробки»** — Тот же API работает для CLI и вебхуков. Начните с кода и позже подключите любой из них.

## Отправьте первое уведомление через API

### 1. Получите API-ключ

Создайте ключ на странице [API Keys](https://pocketalert.app/ru/account/apikeys) и передавайте его в заголовке `Token` в каждом запросе.

### 2. Отправьте сообщение POST-запросом

```
curl -X POST 'https://api.pocketalert.app/v1/messages' \
  -H 'Token: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"title":"Order shipped","message":"Order #1024 is on its way","application_id":"qm47b9pzxzxg"}'
```

### 3. Из вашего кода

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

```
await fetch("https://api.pocketalert.app/v1/messages", {
  method: "POST",
  headers: { Token: process.env.POCKETALERT_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({
    title: "API health check failed",
    message: "GET /v1/orders returned 500",
    application_id: "qm47b9pzxzxg",
    level: "high",
  }),
});
```

Подробнее о начале работы, включая выбор приложения и устройства, читайте в [документации](https://info.pocketalert.app/getting-started.html).

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

### Как отправить уведомление через API?

Выполните POST-запрос к API сообщений Pocket Alert, передав ключ в заголовке Token и JSON-тело с title и message. Уведомление сразу появится на вашем телефоне.

### Как работает аутентификация API?

Аутентификация выполняется с помощью API-ключа со страницы настроек. Ключ передаётся в заголовке Token по HTTPS. Создавайте и перевыпускайте ключи когда нужно и задавайте область действия уведомлений для каждого приложения.

### Какие языки поддерживаются?

Подойдёт любой язык, который умеет делать HTTP-запросы: Node, Python, PHP, Go, Ruby и Rust. Ничего устанавливать не нужно, достаточно обычного REST-вызова из HTTP-клиента, который вы уже используете.

### Что я могу контролировать в запросе?

Задайте title и message, направьте уведомление в конкретное приложение через application_id, адресуйте одно устройство через device_id (или опустите параметр, чтобы отправить на все устройства), и задайте приоритет через level — от silent до critical. Критичное сообщение пробивает режим «Не беспокоить» на Android и проходит «Фокусирование» на iPhone.

### Есть ли также CLI или вебхуки?

Да. CLI Pocket Alert оборачивает тот же API для скриптов и CI. Если хотите обойтись без кода, создайте вебхук и укажите его URL для приёма в нужном сервисе.
