Aller au contenu

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 ​

OffreMessages par jour
Gratuite50
Starter1 000
Medium5 000
LargeIllimité

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 rejected afin 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
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
json
{
  "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 :

bash
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êteSignification
X-PA-Daily-LimitMessages autorisés par jour dans votre offre
X-PA-Daily-RemainingMessages restants aujourd’hui, après celui-ci
X-PA-Daily-ResetHorodatage 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 ​

Documentation de Pocket Alert