Limites quotidiennes de messages
Chaque offre inclut un nombre de messages par jour. Le compteur est réinitialisé à 00:00 UTC. Une fois la limite atteinte, les nouveaux messages sont rejetés avec 429 Too Many Requests jusqu’à la réinitialisation : ils ne sont pas enregistrés et aucune notification push n’est envoyée.
Limites par offre
| Offre | Messages par jour |
|---|---|
| Gratuite | 50 |
| Starter | 1 000 |
| Medium | 5 000 |
| Large | Illimité |
Votre offre actuelle et l’usage du jour se trouvent sur la page Facturation, et sont accessibles via l’API avec GET /v1/messages/usage.
Ce qui est compté
Chaque message créé sur votre compte est compté une fois, le jour UTC de sa création :
- Requêtes API —
POST /v1/messages, y compris les requêtes avec une pièce jointe. - Appels de webhook — chaque appel qui produit un message.
- Messages programmés — comptés le jour où vous les programmez, et non le jour de leur envoi. Un message programmé aujourd’hui pour mardi prochain utilise le quota d’aujourd’hui ; l’envoi lui-même ne consomme jamais de quota et n’est jamais bloqué par celui-ci.
Ce qui n’est pas compté :
- Les requêtes qui échouent à la validation (
400,403) ou qui échouent de notre côté (500) — le quota est recrédité. - Les requêtes rejetées elles-mêmes. Elles sont comptabilisées séparément sous
rejectedafin que vous puissiez voir ce que vous avez manqué.
La suppression de messages ne libère pas de quota
Le compteur suit les messages envoyés, et non les messages stockés. Supprimer des messages — un par un ou tous à la fois — ne rend pas le quota du jour.
Lorsque la limite est atteinte
L’API répond 429 Too Many Requests avec un en-tête Retry-After contenant le nombre de secondes avant la réinitialisation :
HTTP/1.1 429 Too Many Requests
Retry-After: 30142
X-PA-Daily-Limit: 50
X-PA-Daily-Remaining: 0
X-PA-Daily-Reset: 1790035200{
"error": "Daily message limit reached (50/50). New messages are rejected until 00:00 UTC. Upgrade your plan to raise the limit.",
"limit": 50,
"used": 50,
"resets_at": "2026-09-22T00:00:00Z",
"upgrade_url": "https://pocketalert.app/pricing"
}Gérer le 429 dans votre intégration
Considérez 429 comme « pas maintenant », et non comme une erreur passagère. Réessayer avant l’expiration de Retry-After obtient la même réponse : chaque nouvelle tentative est rejetée et comptabilisée. Attendez soit resets_at, soit abandonnez l’alerte et journalisez-la.
curl --retry peut rester bloqué jusqu’à minuit
curl --retry traite 429 comme réessayable et respecte Retry-After, donc un script qui réessaie au-delà de la limite attend jusqu’à 00:00 UTC. Limitez la durée d’attente avec --retry-max-time :
curl --retry 3 --retry-max-time 60 -X POST "https://api.pocketalert.app/v1/messages" ...Webhooks
Les appels de webhook au-delà de la limite sont refusés avec le même 429, mais chacun est tout de même enregistré dans l’historique du webhook, avec sa charge utile complète et le message qu’il aurait produit. L’entrée porte status: "error" et error_code: "daily_limit", donc rien ne disparaît sans trace : ouvrez l’historique pour voir ce qui est arrivé pendant le dépassement de la limite.
En-têtes de limitation de débit
Chaque POST /v1/messages réussi (et chaque appel de webhook qui crée un message) transporte le quota actuel :
| En-tête | Signification |
|---|---|
X-PA-Daily-Limit | Messages autorisés par jour dans votre offre |
X-PA-Daily-Remaining | Messages restants aujourd’hui, après celui-ci |
X-PA-Daily-Reset | Horodatage Unix (secondes) de la prochaine réinitialisation, 00:00 UTC |
Les offres illimitées ne reçoivent pas ces en-têtes.
E-mails
Pocket Alert envoie au titulaire du compte deux e-mails au maximum par jour :
- À 80 % de la limite quotidienne — un avertissement tant qu’il reste de la marge.
- Au premier message rejeté — la limite est atteinte et les nouveaux messages sont refusés.
Les offres illimitées ne reçoivent jamais ces e-mails.
Changer d’offre
Une nouvelle offre s’applique immédiatement : une fois la mise à niveau effectuée, la requête suivante est vérifiée par rapport à la nouvelle limite, sans attendre la réinitialisation. Voir tarifs.
Voir aussi
- Créer un message — la réponse
429dans son contexte - Usage des messages — l’usage du jour via l’API
- Historique des webhooks — où sont conservés les appels de webhook rejetés
- Envoi programmé — comment les messages programmés sont comptés