Ваш телефон в одной команде curl.
Отправляйте push-уведомления на телефон одной командой curl: передайте title и message в API Pocket Alert вместе с вашим ключом, и уведомление появится на iPhone или Android меньше чем за секунду. Работает из любой оболочки, скрипта или машины, где установлен curl.
Путь от терминала до телефона
Вы и так работаете в терминале. Pocket Alert делает ваш телефон доступным одной командой curl: без SDK, без демона и без сервера уведомлений, который нужно поддерживать.
Одна строка, без SDK
Отправьте POST с title и message и заголовком с API-ключом. Никакого SDK, никакого OAuth и никаких зависимостей, кроме самого curl.
Создано для shell-скриптов
Связывайте команды через && и || и отправляйте уведомление при успехе, при ошибке или в обоих случаях. Ваш crontab и CI-скрипты уже умеют это.
JSON или поля формы
JSON или form-data: API сам определяет тип содержимого, так что быстрый вариант из терминала и вариант для скрипта работают одинаково.
Приоритет для каждого сообщения
Добавьте level=critical, чтобы пробиться через беззвучный режим для реальных инцидентов, или level=silent для тихой записи без вибрации.
История включена
Каждое уведомление попадает в историю вместе со статистикой доставки, поэтому сообщение от скрипта, которое отправили и забыли, на самом деле никогда не теряется.
Работает с любой машины
Один и тот же запрос работает с Raspberry Pi, сервера сборки, VPS или WSL: до вашего телефона можно достучаться откуда угодно, где запускается curl.
Три шага от оболочки до кармана
Получите API-ключ
Зарегистрируйтесь бесплатно, создайте ключ на странице API-ключей и экспортируйте его как переменную окружения.
Отправьте запрос через curl
Отправьте title и message на /v1/messages с заголовком Token. Form-data или JSON.
Телефон вибрирует
Push придёт меньше чем за секунду. Связывайте команды через && или || , чтобы получать уведомления об успехе или ошибке.
Отправка push-уведомлений из терминала
1. Однострочная команда
curl -X POST 'https://api.pocketalert.app/v1/messages' \
-H 'Token: YOUR_API_KEY' \
-F 'title=Deploy finished' -F 'message=v2.4.1 is live on production'
Создайте ключ на странице API-ключей. Если вам удобнее JSON, он тоже работает:
curl -X POST 'https://api.pocketalert.app/v1/messages' \
-H 'Token: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"title":"Deploy finished","message":"v2.4.1 is live on production"}'
2. Встройте в любую команду
Получайте уведомление, когда долгая задача завершится, или только если она упала:
# push when the build succeeds
make release && curl -s -X POST 'https://api.pocketalert.app/v1/messages' \
-H 'Token: YOUR_API_KEY' -F 'title=Build OK' -F 'message=make release finished'
# push only on failure, and make it loud
./migrate.sh || curl -s -X POST 'https://api.pocketalert.app/v1/messages' \
-H 'Token: YOUR_API_KEY' \
-F 'title=Migration FAILED' -F 'message=migrate.sh exited non-zero' -F 'level=critical'
3. Оформите в виде функции
Добавьте это в .bashrc / .zshrc, и больше не придётся вводить URL вручную:
notify() {
curl -s -X POST 'https://api.pocketalert.app/v1/messages' \
-H "Token: $POCKETALERT_KEY" \
--form-string "title=$1" --form-string "message=$2" --form-string "level=${3:-default}" > /dev/null
}
# usage
long_task; notify "long_task done" "exit code $?"
notify "Disk warning" "/dev/sda1 at 91%" high
Предпочитаете готовый бинарный файл? CLI Pocket Alert оборачивает тот же API. А поскольку это обычный HTTP, такой же запрос работает из Python, Go, PowerShell или cron-задачи.
Ответы на вопросы
curl -X POST 'https://api.pocketalert.app/v1/messages' -H 'Token: YOUR_API_KEY' -F 'title=Done' -F 'message=Build finished'. Вот и всё: никакого SDK, никакой клиентской библиотеки, никакого OAuth. Отправить может любая машина с curl.
Поддерживаются оба варианта. Эндпоинт принимает application/json и form-data (пары ключ=значение через -d) и сам определяет, что вы отправили. Form-data короче набирать в терминале, а JSON удобнее формировать программно.
Добавьте к команде &&: make build && curl … отправит уведомление только при успехе. Используйте || для уведомлений об ошибке или ; чтобы получать сообщение в любом случае. Для долгих задач сохраните код возврата и поместите его в текст сообщения, чтобы push сообщал, что именно произошло.
Добавьте -F 'level=critical', и push обойдёт режим «Не беспокоить» на Android и пробьётся через «Фокусирование» на iPhone. Используйте level=silent для уведомлений, которые должны сохраниться в истории без звука. Всего пять уровней: silent, low, default, high, critical.
Создайте его на странице API-ключей после регистрации. Храните ключ в переменной окружения или в менеджере секретов, а не прописывайте в скриптах. В бесплатном тарифе доступно 50 сообщений в день, этого хватит на напряжённый день работы со скриптами.
Ваш терминал может вибрировать у вас в кармане.
Один API-ключ, одна строка curl, и любой терминал, с которым вы работаете, сможет достучаться до вашего телефона.