# 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](https://pocketalert.app/account/billing), et sont accessibles via l’API avec [`GET /v1/messages/usage`](https://info.pocketalert.app/api/messages/usage.md).

## 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`](https://info.pocketalert.app/api/messages/create.md), 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é.

> **Warning: 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"
}
```

> **Tip: 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.

> **Warning: `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](https://info.pocketalert.app/api/webhooks/history.md) 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](https://pocketalert.app/pricing).

## Voir aussi

- [Créer un message](https://info.pocketalert.app/api/messages/create.md) — la réponse `429` dans son contexte
- [Usage des messages](https://info.pocketalert.app/api/messages/usage.md) — l’usage du jour via l’API
- [Historique des webhooks](https://info.pocketalert.app/api/webhooks/history.md) — où sont conservés les appels de webhook rejetés
- [Envoi programmé](https://info.pocketalert.app/features/scheduled-delivery.md) — comment les messages programmés sont comptés
