# Tu teléfono, a un curl de distancia.

> Envía una notificación push a tu teléfono con un solo comando curl. Haz POST a la API de Pocket Alert desde cualquier terminal, script bash o tarea cron. Sin SDK y con plan gratuito incluido.

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

Última actualización: 2026-10-25

Envía una notificación push a tu teléfono con un solo comando curl: haz un POST de un title y un message a la API de Pocket Alert con tu clave, y llegará a tu iPhone o Android en menos de un segundo. Funciona desde cualquier shell, script o equipo que tenga curl.

## Tres pasos de la shell al bolsillo

1. **Obtén una clave de API** — Regístrate gratis, crea una clave en la página de claves de API y expórtala como variable de entorno.
2. **Haz curl a la API** — Haz un POST de title y message a /v1/messages con la cabecera Token. Form-data o JSON.
3. **El teléfono vibra** — La notificación llega en menos de un segundo. Encadénalo con && o || para avisar en caso de éxito o fallo.

## De la terminal al teléfono

Ya trabajas en la terminal. Pocket Alert pone tu teléfono a un curl de distancia, sin SDK, sin daemon y sin servidor de notificaciones que mantener.

- **Una línea, sin SDK** — Envía title y message en un POST con la cabecera de la clave de API. Sin SDK, sin OAuth y sin más dependencias que el propio curl.
- **Pensado para scripts de shell** — Encadénalo con && y || para notificar en caso de éxito, fallo o ambos. Tu crontab y tus scripts de CI ya saben cómo.
- **JSON o campos de formulario** — JSON o form-data: la API detecta el tipo de contenido, así que tanto la versión rápida de terminal como la versión en script funcionan.
- **Prioridad por mensaje** — Añade level=critical para saltarte el modo silencioso en incidentes reales, o level=silent para un registro discreto que no vibra.
- **Historial incluido** — Cada notificación queda en tu historial con estadísticas de entrega, así que un mensaje de un script que olvidaste nunca se pierde de verdad.
- **Funciona desde cualquier equipo** — La misma petición funciona desde una Raspberry Pi, un servidor de compilación, un VPS o WSL: donde se ejecute curl, puedes llegar a tu teléfono.

## Envía una notificación push desde tu terminal

### 1. La línea de una sola instrucción

```
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'
```

Crea una clave en la página de [claves de API](https://pocketalert.app/es/account/apikeys). JSON también funciona, si lo prefieres:

```
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. Encadénalo con cualquier cosa

Avisa cuando termine una tarea lenta, o solo si falla:

```
# 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. Envuélvelo en una función

Pega esto en tu `.bashrc` / `.zshrc` y no vuelvas a escribir la 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
```

¿Prefieres un binario? La [CLI de Pocket Alert](https://pocketalert.app/es/tools/cli) envuelve la misma API. Y como es HTTP sencillo, la misma llamada funciona desde Python, Go, PowerShell o una [tarea cron](https://pocketalert.app/es/use-cases/cron-job-alerts).

## Preguntas frecuentes

### ¿Cuál es el comando curl mínimo para enviar una notificación push?

curl -X POST 'https://api.pocketalert.app/v1/messages' -H 'Token: YOUR_API_KEY' -F 'title=Done' -F 'message=Build finished'. Eso es todo: sin SDK, sin biblioteca cliente, sin flujo de OAuth. Cualquier máquina con curl puede enviar.

### ¿La API acepta JSON o campos de formulario?

Ambos. El endpoint acepta application/json y form-data (pares clave=valor con -d), y detecta cuál enviaste. Form-data es más corto de escribir en una terminal; JSON es más fácil de generar desde código.

### ¿Cómo recibo una notificación cuando termina un comando largo?

Añade tu comando con &&: make build && curl … se ejecuta solo si tiene éxito. Usa || para alertas de fallo, o ; para notificar en ambos casos. En trabajos largos, guarda el código de salida y ponlo en el mensaje para que la notificación te diga qué pasó.

### ¿Puedo definir la prioridad desde la línea de comandos?

Sí. Añade -F 'level=critical' y la notificación ignora No molestar en Android y atraviesa Concentración en iPhone. Usa level=silent para avisos que quieras dejar registrados sin sonido. Hay cinco niveles: silent, low, default, high, critical.

### ¿De dónde sale la clave de API?

Créala en la página de claves de API después de registrarte. Guárdala en una variable de entorno o en tu gestor de secretos, no la escribas directamente en los scripts. El plan gratuito incluye 50 mensajes al día, suficiente para un día cargado de scripts.
