# Qu’est-ce qu’une API de notifications push, et quand en avez-vous besoin ?

> Une API de notifications push transforme une requête HTTP en alerte sur un téléphone. Ce qu’elle fait, les deux types de produits qui portent ce nom, à quoi ressemble une requête et ce qu’il faut vérifier avant d’en choisir une.

*04.10.2026*

<!-- source: https://pocketalert.app/fr/blog/what-is-a-push-notification-api -->

Une API de notifications push est un service web qui affiche un message sur l’écran verrouillé d’un téléphone lorsque votre code le lui demande. Vous envoyez une requête HTTP avec un titre et un corps, le service la transmet à Apple ou à Google, et le téléphone l’affiche en quelques secondes, qu’une application soit ouverte ou non.

C’est toute l’idée. Les détails dépendent de la personne à qui la notification est destinée et de la part de la chaîne de distribution que vous voulez maîtriser.

## Deux choses différentes portent le même nom

Si vous recherchez « API de notifications push », vous obtenez deux types de produits qui se recoupent à peine.

**Les plateformes qui envoient des notifications à vos utilisateurs.** Firebase Cloud Messaging, Apple Push Notification service, OneSignal et d’autres similaires. Vous développez une application mobile, la publiez sur l’App Store et Google Play, collectez un jeton d’appareil à chaque installation et envoyez des notifications produit ou marketing à des milliers de personnes. L’API est la dernière étape d’un long projet.

**Les services qui vous envoient des notifications.** Pocket Alert, Pushover, ntfy et d’autres. L’application existe déjà : vous l’installez sur votre propre téléphone, obtenez une clé API et envoyez des alertes depuis vos scripts, vos serveurs et d’autres services. Rien à publier, aucun jeton à collecter. Un déploiement est terminé, une sauvegarde a échoué, un paiement vient d’arriver.

Ce guide porte sur le second type. Si vous développez une application grand public et devez atteindre ses utilisateurs, vous avez besoin du premier type, et la plupart de ce qui suit ne vous concernera pas.

## Ce qui se passe lorsque vous en envoyez une

Quatre étapes, dont la plupart sont invisibles :

1. Votre code envoie une requête HTTPS au service avec un titre, un message et votre clé API.
2. Le service vérifie la clé, enregistre le message et décide où il doit aller : sur lequel de vos appareils et avec quelle priorité.
3. Il transmet la notification au réseau push de la plateforme, APNs pour iPhone et Firebase Cloud Messaging pour Android.
4. Apple ou Google la livre par la connexion que chaque téléphone maintient déjà avec eux, et le téléphone l’affiche.

Les étapes 3 et 4 expliquent pourquoi le push fonctionne alors que l’application est fermée, sans épuiser la batterie : le téléphone n’interroge jamais personne. Le parcours complet est décrit dans [Fonctionnement des notifications push : APNs et FCM](/blog/how-push-notifications-work-apns-fcm).

## Pourquoi ne pas parler directement à Apple et Google ?

Vous le pouvez, si vous avez votre propre application dans les deux stores. Pour envoyer une notification à votre propre téléphone sans intermédiaire, il vous faudrait :

- Un abonnement au Apple Developer Program et une application iOS intégrant l’entitlement push, plus un projet Firebase et une application Android pour l’autre moitié.
- Une clé de signature APNs et un compte de service Firebase, ainsi que du code qui signe les requêtes pour chacun.
- Un moyen de collecter les jetons d’appareil depuis l’application et de les tenir à jour à chaque changement.
- Deux formats de requête, deux modèles de priorité et deux jeux de codes d’erreur.

C’est un projet raisonnable lorsque l’application est votre produit. Pour un « prévenez-moi quand la tâche cron échoue », c’est beaucoup de mécanique. Un service de notifications push a déjà fait tout ce travail une fois, pour tout le monde.

## À quoi ressemble une requête

Avec Pocket Alert, envoyer une notification revient à une seule requête POST authentifiée :

```bash
curl -X POST https://api.pocketalert.app/v1/messages \
  -H 'Token: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"title": "Deploy finished", "message": "api v2.4.1 is live"}'
```

La réponse est `201 Created` avec le message enregistré et la priorité avec laquelle il a été envoyé. La même requête fonctionne depuis n’importe quel langage disposant d’un client HTTP, et [Envoyer des notifications push avec curl](/use-cases/curl-push-notifications) propose davantage d’exemples en terminal.

Seuls `title` et `message` sont obligatoires. Les champs facultatifs les plus utiles pour les alertes :

- `level` définit le volume de la notification : `silent`, `low`, `default`, `high` ou `critical`.
- `actions` ajoute jusqu’à trois boutons d’action à la notification : ouvrir une URL, déclencher une requête HTTP ou copier une valeur.
- `send_at` ou `delay` envoie la notification plus tard plutôt que tout de suite (offres payantes).
- `application_id` et `device_id` indiquent à quel projet elle appartient et quel téléphone la reçoit.

## Trois portes d’entrée, pas seulement l’API

Une API de notifications push est surtout utile lorsque vous n’avez pas à écrire de code pour chaque source.

- **L’API HTTP** pour vos propres scripts, tâches et applications.
- **Les URL de webhook** pour les services qui envoient déjà des webhooks. GitHub, Stripe, Grafana ou Sentry publient leur propre JSON vers un webhook Pocket Alert, et des espaces réservés comme `%repository.name%` extraient les champs voulus pour la notification, sans code intermédiaire. [Créer votre première URL de webhook](/blog/create-your-first-webhook-url) vous guide pas à pas.
- **La CLI et le serveur MCP** pour le terminal et les agents d’IA : `pocketalert send "Build done" "All tests passed"` depuis un shell ([CLI](/tools/cli)), ou un outil `create_message` que Claude ou Cursor appelle à la fin d’une longue tâche ([MCP](/tools/mcp)).

## Dans quels cas en utiliser une

La plupart des alertes entrent dans quelques catégories :

- **Quelque chose a cassé.** Un serveur ne répond plus, une tâche cron s’est terminée avec un code non nul, une sauvegarde n’a pas été exécutée. Voir [alertes de tâches cron](/use-cases/cron-job-alerts) et [surveillance de serveurs](/use-cases/server-monitoring).
- **Quelque chose est terminé.** Un déploiement, un long build, une impression 3D de 12 heures, la tâche d’un agent d’IA. Voir [alertes de déploiement](/use-cases/deployment-alerts).
- **Quelque chose d’important s’est produit.** Un paiement, une inscription, un envoi de formulaire. Voir [alertes de paiement](/use-cases/payment-alerts) et [alertes d’inscription](/use-cases/signup-alerts).
- **Quelque chose est sur le point de se produire.** Un certificat qui expire dans 14 jours. Voir [alertes d’expiration SSL](/use-cases/ssl-expiration-alerts).

Le point commun est un événement dont quelqu’un doit être informé maintenant, et non à la prochaine ouverture d’un tableau de bord ou de sa boîte de réception.

## Ce qu’il faut vérifier avant d’en choisir une

Tous les services de ce domaine envoient un push à partir d’une requête HTTP. Les différences se trouvent dans tout ce qui entoure cette requête :

- **Plateformes.** Certains ne fonctionnent que sur iPhone (Bark, The Notification App), et l’unique application officielle de Gotify est destinée à Android. Si la personne qui doit recevoir l’alerte utilise l’autre système, la question est réglée.
- **Niveaux de priorité.** Une sauvegarde échouée peut-elle se signaler différemment d’une nouvelle inscription ? Une alerte critique peut-elle passer outre le mode Ne pas déranger ?
- **Webhooks entrants.** Un service peut-il envoyer son propre JSON, ou chaque source a-t-elle besoin d’un script pour le remodeler ?
- **Historique et journaux.** Lorsqu’une alerte n’est pas arrivée, existe-t-il une trace de l’appel et de ce qui lui est arrivé ?
- **Limites et tarifs.** Par jour, par mois ou à vie, et que se passe-t-il lorsque la limite est atteinte ?
- **Hébergement.** Un service hébergé, ou un serveur que vous maintenez vous-même.

Nous comparons Pocket Alert à Pushover, ntfy, Pushbullet, Bark, Gotify et d’autres sur exactement ces points dans [Alternatives](/alternatives), y compris les cas où chacun d’eux est le meilleur choix.

## FAQ

### Une API de notifications push est-elle la même chose que Firebase Cloud Messaging ?

FCM est une API de notifications push : celle que Google fournit pour les applications que vous développez et publiez. Des services comme Pocket Alert s’appuient sur FCM et APNs et prennent en charge l’application, les clés et les jetons d’appareil, de sorte que vous n’avez qu’à envoyer la requête HTTP.

### Dois-je développer une application mobile ?

Pas pour recevoir des alertes à votre attention ou à celle de votre équipe. Vous installez une application existante, comme Pocket Alert pour [iPhone ou Android](/get-app), et vous lui envoyez les messages. Vous n’avez besoin de votre propre application que pour envoyer des notifications à vos propres utilisateurs.

### Est-ce gratuit ?

De nombreux services proposent une offre gratuite. Celle de Pocket Alert permet 50 messages par jour sans carte bancaire, ce qui couvre la plupart des alertes personnelles, et les offres payantes commencent à 6 $ par mois pour 1 000 messages par jour. Détails sur la [page tarifs](/pricing).

### La livraison est-elle rapide ?

En général, quelques secondes entre la requête et l’écran verrouillé. Apple et Google ne garantissent toutefois aucun délai : un téléphone sans réseau ou en mode d’économie de batterie strict reçoit la notification lorsqu’il se reconnecte.

### Push, SMS ou e-mail ?

Le push pour ce qui demande une attention immédiate, l’e-mail pour les récapitulatifs et les archives, le SMS lorsque la personne n’a aucune application sur smartphone. Les compromis sont détaillés dans [Notifications push ou SMS](/blog/push-notifications-vs-sms) et [Notifications push ou alertes par e-mail](/blog/push-vs-email-alerts).

[Créez un compte gratuit](/signup), copiez votre clé API, et la commande curl ci-dessus sera votre premier push.
