# Votre téléphone, à une commande curl.

> Envoyez une notification push sur votre téléphone avec une seule commande curl. Faites un POST vers l’API Pocket Alert depuis n’importe quel terminal, script bash ou tâche cron : sans SDK, offre gratuite incluse.

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

Dernière mise à jour : 2026-10-25

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.

## Trois étapes, du shell à votre poche

1. **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.
2. **Appelez l’API avec curl** — Envoyez title et message en POST vers /v1/messages avec l’en-tête Token. Form-data ou JSON.
3. **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.

## 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.

## 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](https://pocketalert.app/fr/account/apikeys). 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](https://pocketalert.app/fr/tools/cli) 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](https://pocketalert.app/fr/use-cases/cron-job-alerts).

## FAQ

### Quelle est la commande curl minimale pour envoyer une notification push ?

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.

### L’API accepte-t-elle JSON ou des champs de formulaire ?

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.

### Comment être averti lorsqu’une commande longue se termine ?

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é.

### Puis-je définir la priorité depuis la ligne de commande ?

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.

### D’où vient la clé API ?

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.
