# Ваш телефон в одной команде curl.

> Отправьте push-уведомление на телефон одной командой curl. POST-запрос к API Pocket Alert из любого терминала, bash-скрипта или cron-задачи — без SDK, есть бесплатный тариф.

<!-- source: https://pocketalert.app/ru/use-cases/curl-push-notifications -->

Обновлено: 2026-10-25

Отправляйте push-уведомления на телефон одной командой curl: передайте title и message в API Pocket Alert вместе с вашим ключом, и уведомление появится на iPhone или Android меньше чем за секунду. Работает из любой оболочки, скрипта или машины, где установлен curl.

## Три шага от оболочки до кармана

1. **Получите API-ключ** — Зарегистрируйтесь бесплатно, создайте ключ на странице API-ключей и экспортируйте его как переменную окружения.
2. **Отправьте запрос через curl** — Отправьте title и message на /v1/messages с заголовком Token. Form-data или JSON.
3. **Телефон вибрирует** — Push придёт меньше чем за секунду. Связывайте команды через && или || , чтобы получать уведомления об успехе или ошибке.

## Путь от терминала до телефона

Вы и так работаете в терминале. 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.

## Отправка 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-ключей](https://pocketalert.app/ru/account/apikeys). Если вам удобнее 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](https://pocketalert.app/ru/tools/cli) оборачивает тот же API. А поскольку это обычный HTTP, такой же запрос работает из Python, Go, PowerShell или [cron-задачи](https://pocketalert.app/ru/use-cases/cron-job-alerts).

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

### Какая минимальная команда curl нужна для отправки push-уведомления?

curl -X POST 'https://api.pocketalert.app/v1/messages' -H 'Token: YOUR_API_KEY' -F 'title=Done' -F 'message=Build finished'. Вот и всё: никакого SDK, никакой клиентской библиотеки, никакого OAuth. Отправить может любая машина с curl.

### API принимает JSON или поля формы?

Поддерживаются оба варианта. Эндпоинт принимает 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-ключ?

Создайте его на странице API-ключей после регистрации. Храните ключ в переменной окружения или в менеджере секретов, а не прописывайте в скриптах. В бесплатном тарифе доступно 50 сообщений в день, этого хватит на напряжённый день работы со скриптами.
