Votre téléphone, à une commande curl.
Envoyez une notification push sur votre téléphone avec une seule commande curl : un POST de title et message vers l’API Pocket Alert, avec votre clé, et elle arrive sur votre iPhone ou Android en moins d’une seconde. Fonctionne depuis n’importe quel shell, script ou machine disposant de curl.
Du terminal au téléphone, en un seul flux
Vous travaillez déjà dans le terminal. Pocket Alert place votre téléphone à une commande curl de distance, sans SDK, sans démon, sans serveur de notifications à faire tourner.
Une ligne, sans SDK
Envoyez title et message en POST avec un en-tête de clé API. Pas de SDK, pas d’OAuth, aucune dépendance autre que curl lui-même.
Conçu pour les scripts shell
Enchaînez avec && et || pour envoyer en cas de succès, d’échec ou dans les deux cas. Votre crontab et vos scripts CI savent déjà faire.
JSON ou champs de formulaire
JSON ou form-data : l’API détecte le type de contenu, donc la version rapide en terminal comme la version scriptée fonctionnent.
Priorité par message
Ajoutez level=critical pour percer le mode silencieux lors d’incidents réels, ou level=silent pour un journal discret qui ne vibre pas.
Historique inclus
Chaque notification est enregistrée dans votre historique avec les statistiques de livraison : un message de script oublié ne se perd donc jamais.
Fonctionne sur toutes les machines
La même requête fonctionne depuis un Raspberry Pi, un serveur de build, un VPS ou WSL : partout où curl est disponible, votre téléphone est joignable.
Trois étapes, du shell à votre poche
Obtenir une clé API
Créez un compte gratuit, générez une clé sur la page des clés API, puis exportez-la comme variable d’environnement.
Appelez l’API avec curl
Envoyez title et message en POST vers /v1/messages avec l’en-tête Token. Form-data ou JSON.
Le téléphone vibre
La notification arrive en moins d’une seconde. Enchaînez avec && ou || pour être alerté en cas de succès ou d’échec.
Envoyer une notification push depuis votre terminal
1. La commande en une ligne
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'
Créez une clé sur la page clés API. Le JSON fonctionne aussi, si vous le préférez :
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. Enchaînez-la à n’importe quelle commande
Soyez averti lorsqu’un traitement long se termine, ou seulement en cas d’échec :
# 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. Encapsulez-la dans une fonction
Ajoutez ceci dans votre .bashrc / .zshrc et ne tapez plus jamais 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
Vous préférez un binaire dédié ? La CLI Pocket Alert encapsule la même API. Et comme il s’agit de simple HTTP, le même appel fonctionne depuis Python, Go, PowerShell ou une tâche cron.
Vos questions, nos réponses
curl -X POST 'https://api.pocketalert.app/v1/messages' -H 'Token: YOUR_API_KEY' -F 'title=Done' -F 'message=Build finished'. C’est tout : pas de SDK, pas de bibliothèque cliente, pas de procédure OAuth. Toute machine disposant de curl peut envoyer.
Les deux. L’API accepte application/json et form-data (paires -d clé=valeur), et détecte celui que vous envoyez. Form-data est plus court à saisir dans un terminal ; JSON est plus pratique à générer par programme.
Ajoutez && à votre commande : make build && curl … ne se déclenche qu’en cas de succès. Utilisez || pour les alertes d’échec, ou ; pour être notifié dans tous les cas. Pour les longs traitements, récupérez le code de sortie et placez-le dans le message afin que la notification vous indique ce qui s’est passé.
Ajoutez -F 'level=critical' et la notification contourne le mode Ne pas déranger sur Android et passe le mode Concentration sur iPhone. Utilisez level=silent pour les signaux que vous souhaitez conserver sans son. Cinq niveaux : silent, low, default, high, critical.
Créez-la sur la page des clés API après votre inscription. Placez-la dans une variable d’environnement ou dans votre gestionnaire de secrets plutôt que de la coder en dur dans vos scripts. L’offre gratuite inclut 50 messages par jour, de quoi couvrir une journée chargée de scripts.
Votre terminal peut faire vibrer votre poche.
Une clé API, une ligne curl, et chaque terminal que vous utilisez peut atteindre votre téléphone.