Riga di comando

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.

Solo curlJSON o form-dataGratis: 50/giornoAggiornato il
Funzionalità

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.

Per iniziare

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.

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.

FAQ

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.