Отправляйте push-уведомления с вашего бэкенда.
API Pocket Alert отправляет push-уведомление на ваш телефон одним аутентифицированным HTTP POST-запросом. Вызывайте его из Node, Python, PHP или Go, передавайте заголовок, текст и уровень приоритета, и уведомление почти мгновенно появится на iPhone или Android.
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 и вебхуков. Начните с кода и позже подключите любой из них.
Три шага до первого push-уведомления через API
Получите API-ключ
Создайте API-ключ на странице API Keys и сохраните его в переменной окружения.
Отправьте запрос
Отправьте JSON с title и message на эндпоинт сообщений, передав ключ в заголовке Token.
Запустите в работу
Телефон завибрирует меньше чем через секунду. По мере роста потребностей добавляйте маршрутизацию по приложению и устройству.
Отправьте первое уведомление через API
1. Получите API-ключ
Создайте ключ на странице API Keys и передавайте его в заголовке 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",
}),
});
Подробнее о начале работы, включая выбор приложения и устройства, читайте в документации.
Ответы на вопросы
Выполните POST-запрос к API сообщений Pocket Alert, передав ключ в заголовке Token и JSON-тело с title и message. Уведомление сразу появится на вашем телефоне.
Аутентификация выполняется с помощью API-ключа со страницы настроек. Ключ передаётся в заголовке Token по HTTPS. Создавайте и перевыпускайте ключи когда нужно и задавайте область действия уведомлений для каждого приложения.
Подойдёт любой язык, который умеет делать HTTP-запросы: Node, Python, PHP, Go, Ruby и Rust. Ничего устанавливать не нужно, достаточно обычного REST-вызова из HTTP-клиента, который вы уже используете.
Задайте title и message, направьте уведомление в конкретное приложение через application_id, адресуйте одно устройство через device_id (или опустите параметр, чтобы отправить на все устройства), и задайте приоритет через level — от silent до critical. Критичное сообщение пробивает режим «Не беспокоить» на Android и проходит «Фокусирование» на iPhone.
Да. CLI Pocket Alert оборачивает тот же API для скриптов и CI. Если хотите обойтись без кода, создайте вебхук и укажите его URL для приёма в нужном сервисе.
Один запрос — сразу на телефон.
Создайте API-ключ и отправьте первое push-уведомление с вашего бэкенда.