# Envoyez une notification push depuis votre backend.

> Envoyez des notifications push depuis votre backend avec l’API Pocket Alert. Un simple HTTP POST authentifié depuis Node, Python, PHP ou Go, et votre téléphone sonne en une seconde.

<!-- source: https://pocketalert.app/fr/use-cases/api-alerts -->

Dernière mise à jour : 2026-08-11

L’API Pocket Alert envoie une notification push sur votre téléphone avec une seule requête POST authentifiée. Déclenchez-la depuis Node, Python, PHP ou Go, avec le title, le message et le niveau de priorité, et elle atteint votre iPhone ou votre Android presque instantanément.

## Trois étapes pour votre première notification push via API

1. **Obtenez une clé API** — Créez une clé API sur la page Clés API et conservez-la dans une variable d’environnement.
2. **Envoyez une requête** — Envoyez en POST un title et un message au format JSON vers le point de terminaison des messages, avec la clé dans l’en-tête Token.
3. **Mettez-la en production** — Votre téléphone vibre en moins d’une seconde. Ajoutez le ciblage par application et par appareil à mesure que vos besoins évoluent.

## Des notifications à une seule requête

L’API alimente chaque alerte Pocket Alert. Intégrez-la à votre backend avec une seule requête.

- **REST simple, sans SDK** — Un seul POST authentifié envoie une notification push depuis le client HTTP que vous utilisez déjà. Ni SDK, ni file d’attente, ni broker.
- **Tous les langages** — Node, Python, PHP, Go et Ruby peuvent tous déclencher une notification Pocket Alert.
- **Authentification par clé** — Votre clé API est transmise dans l’en-tête Token via HTTPS. Créez, limitez et renouvelez vos clés à votre rythme.
- **Contrôle total** — Routez avec application_id et ciblez un seul device_id, ou omettez-le pour atteindre tous les appareils, en un seul appel.
- **Livraison en moins d’une seconde** — Les notifications push arrivent sur votre iPhone ou votre Android en moins d’une seconde, assez rapidement pour piloter des alertes backend en temps réel.
- **CLI et webhook prêts** — La même API alimente la CLI et les webhooks. Commencez par le code et ajoutez l’un ou l’autre plus tard.

## Envoyez votre première notification API

### 1. Obtenez une clé API

Créez une clé sur la page [Clés API](https://pocketalert.app/fr/account/apikeys) et transmettez-la dans l’en-tête `Token` à chaque requête.

### 2. Envoyez un message avec POST

```
curl -X POST 'https://api.pocketalert.app/v1/messages' \
  -H 'Token: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"title":"Order shipped","message":"Order #1024 is on its way","application_id":"qm47b9pzxzxg"}'
```

### 3. Depuis votre code

Appelez-la depuis l’endroit où un point de terminaison renvoie une erreur ou où un événement personnalisé se déclenche, par exemple après un échec de contrôle de santé ou une nouvelle commande :

```
await fetch("https://api.pocketalert.app/v1/messages", {
  method: "POST",
  headers: { Token: process.env.POCKETALERT_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({
    title: "API health check failed",
    message: "GET /v1/orders returned 500",
    application_id: "qm47b9pzxzxg",
    level: "high",
  }),
});
```

La [documentation de démarrage](https://info.pocketalert.app/getting-started.html) complète détaille le ciblage des applications et des appareils.

## FAQ

### Comment envoyer une notification push via API ?

Faites un POST vers l’API de messages de Pocket Alert, avec votre clé dans l’en-tête Token et un corps JSON contenant le title et le message. La notification arrive immédiatement sur votre téléphone.

### Comment fonctionne l’authentification API ?

Authentifiez-vous avec une clé API générée sur la page Paramètres, transmise dans l’en-tête Token via HTTPS. Créez et renouvelez vos clés quand vous le souhaitez, et limitez les alertes par application.

### Quels langages sont pris en charge ?

Tout langage capable d’effectuer une requête HTTP convient : Node, Python, PHP, Go, Ruby et Rust. Rien à installer, il suffit d’un appel REST simple depuis le client HTTP que vous utilisez déjà.

### Que puis-je contrôler dans la requête ?

Définissez le title et le message, routez vers une application précise avec application_id, ciblez un appareil avec device_id (ou omettez-le pour atteindre tous les appareils), et réglez la priorité avec level, de silencieux à critique. Un message critique passe outre le mode Ne pas déranger sur Android et la Concentration sur iPhone.

### Existe-t-il aussi une CLI ou une option webhook ?

Oui. La CLI Pocket Alert encapsule la même API pour les scripts et la CI. Si vous préférez ne pas écrire de code, créez un webhook et pointez un service vers son URL de réception.
