API для разработчиков

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

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

Push за <1 сПростой RESTNode · Python · Go · PHPОбновлено
Возможности

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

1

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

Создайте API-ключ на странице API Keys и сохраните его в переменной окружения.

2

Отправьте запрос

Отправьте JSON с title и message на эндпоинт сообщений, передав ключ в заголовке Token.

3

Запустите в работу

Телефон завибрирует меньше чем через секунду. По мере роста потребностей добавляйте маршрутизацию по приложению и устройству.

Отправьте первое уведомление через 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",
  }),
});

Подробнее о начале работы, включая выбор приложения и устройства, читайте в документации.

FAQ

Ответы на вопросы

Выполните 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-уведомление с вашего бэкенда.