Il tuo telefono, a un curl di distanza.
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.
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.
Tre passaggi dalla shell alla tasca
Ottieni una chiave API
Registrati gratis, crea una chiave nella pagina delle chiavi API ed esportala come variabile d'ambiente.
Chiama l'API con curl
Invia title e message a /v1/messages con l'header Token. Form-data o JSON.
Il telefono vibra
La push arriva in meno di un secondo. Concatena con && o || per avvisare in caso di successo o errore.
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. 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 incapsula la stessa API. E poiché è HTTP semplice, la stessa chiamata funziona da Python, Go, PowerShell o da un cron job.
Le risposte alle tue domande
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.
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.
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.
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.
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.
Il tuo terminale può far vibrare la tasca.
Una chiave API, una riga di curl e ogni terminale che usi può raggiungere il tuo telefono.