# Il tuo telefono, a un curl di distanza.

> Invia una notifica push al tuo telefono con un solo comando curl. Fai una POST all'API di Pocket Alert da qualsiasi terminale, script bash o cron job: nessun SDK, piano gratuito incluso.

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

Ultimo aggiornamento: 2026-10-25

Invia una notifica push al telefono con un singolo comando curl: POST di un title e un message all'API di Pocket Alert con la tua chiave, e arriva su iPhone o Android in meno di un secondo. Funziona da qualsiasi shell, script o macchina che abbia curl.

## Tre passaggi dalla shell alla tasca

1. **Ottieni una chiave API** — Registrati gratis, crea una chiave nella pagina delle chiavi API ed esportala come variabile d'ambiente.
2. **Chiama l'API con curl** — Invia title e message a /v1/messages con l'header Token. Form-data o JSON.
3. **Il telefono vibra** — La push arriva in meno di un secondo. Concatena con && o || per avvisare in caso di successo o errore.

## La pipeline dal terminale al telefono

Lavori già nel terminale. Pocket Alert mette il tuo telefono a un curl di distanza, senza SDK, senza daemon e senza un server di notifiche da gestire.

- **Una riga, nessun SDK** — Invia title e message con un header della chiave API. Niente SDK, niente OAuth, nessuna dipendenza oltre a curl stesso.
- **Pensato per gli script di shell** — Concatena con && e || per inviare in caso di successo, errore o entrambi. Il tuo crontab e gli script CI già lo sanno fare.
- **JSON o campi di form** — JSON o form-data: l'API riconosce il content type, quindi funzionano sia la versione rapida da terminale sia quella da script.
- **Priorità per ogni messaggio** — Aggiungi level=critical per superare la modalità silenziosa in caso di incidenti reali, oppure level=silent per un registro silenzioso che non fa vibrare.
- **Cronologia inclusa** — Ogni push finisce nella cronologia con le statistiche di consegna, quindi un messaggio di uno script lanciato e dimenticato non va davvero perso.
- **Funziona su qualsiasi macchina** — La stessa richiesta funziona da un Raspberry Pi, un build server, un VPS o WSL: ovunque giri curl, il tuo telefono è raggiungibile.

## Invia una notifica push dal terminale

### 1. La riga singola

```
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 chiave nella pagina [Chiavi API](https://pocketalert.app/it/account/apikeys). Se preferisci, funziona anche il 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. Concatenala a qualsiasi cosa

Ricevi una notifica quando un job lento termina, oppure solo se fallisce:

```
# 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. Incapsulala in una funzione

Aggiungi questo al tuo `.bashrc` / `.zshrc` e non digitare mai più l'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
```

Preferisci un binario vero? La [CLI di Pocket Alert](https://pocketalert.app/it/tools/cli) incapsula la stessa API. E poiché è HTTP semplice, la stessa chiamata funziona da Python, Go, PowerShell o da un [cron job](https://pocketalert.app/it/use-cases/cron-job-alerts).

## FAQ

### Qual è il comando curl minimo per inviare una notifica push?

curl -X POST 'https://api.pocketalert.app/v1/messages' -H 'Token: YOUR_API_KEY' -F 'title=Done' -F 'message=Build finished'. Tutto qui: niente SDK, niente librerie client, niente giri di OAuth. Qualsiasi macchina con curl può inviare.

### L'API accetta JSON o campi di form?

Entrambi. L'endpoint accetta application/json e form-data (coppie -d chiave=valore) e riconosce quale hai inviato. Il form-data è più veloce da digitare nel terminale; il JSON è più comodo da generare via codice.

### Come ricevo una notifica quando un comando lungo termina?

Aggiungi &&, dopo il comando: make build && curl … si attiva solo in caso di successo. Usa || per gli avvisi di errore, oppure ; per notificare in ogni caso. Per i job lunghi, salva il codice di uscita e includilo nel messaggio, così la push ti dice com'è andata.

### Posso impostare la priorità dalla riga di comando?

Aggiungi -F 'level=critical' e la push aggira Non disturbare su Android e passa anche la modalità Full immersion su iPhone. Usa level=silent per avvisi che vuoi registrati senza suono. I livelli sono cinque: silent, low, default, high, critical.

### Da dove arriva la chiave API?

Creala nella pagina delle chiavi API dopo la registrazione. Mettila in una variabile d'ambiente o nel tuo gestore di segreti, invece di scriverla fissa negli script. Il piano gratuito include 50 messaggi al giorno, abbastanza per una giornata intensa di script.
