# Tageslimit für Nachrichten

Jeder Tarif enthält eine feste Anzahl an Nachrichten pro Tag. Der Zähler wird um **00:00 UTC** zurückgesetzt. Sobald du das Limit erreichst, werden neue Nachrichten mit `429 Too Many Requests` abgelehnt, bis der Reset erfolgt. Sie werden nicht gespeichert und es wird keine Push-Benachrichtigung gesendet.

## Limits nach Tarif

| Tarif | Nachrichten pro Tag |
|-------|-------------------:|
| Free | 50 |
| Starter | 1.000 |
| Medium | 5.000 |
| Large | Unbegrenzt |

Deinen aktuellen Tarif und die heutige Nutzung findest du auf der Seite [Abrechnung](https://pocketalert.app/account/billing). Außerdem kannst du sie über die API abrufen: [`GET /v1/messages/usage`](https://info.pocketalert.app/api/messages/usage.md).

## Was zählt

Jede Nachricht, die in deinem Konto erstellt wird, zählt einmal, und zwar an dem UTC-Tag, an dem sie erstellt wurde:

- **API-Anfragen**: [`POST /v1/messages`](https://info.pocketalert.app/api/messages/create.md), auch Anfragen mit Anhang.
- **Webhook-Aufrufe**: jeder Aufruf, der eine Nachricht erzeugt.
- **Geplante Nachrichten**: Sie zählen an dem Tag, an dem du sie **planst**, nicht an dem Tag, an dem sie zugestellt werden. Eine heute für nächsten Dienstag geplante Nachricht nutzt das heutige Kontingent. Die Zustellung selbst verbraucht nie Kontingent und wird davon auch nicht blockiert.

Nicht gezählt werden:

- Anfragen, die die Validierung nicht bestehen (`400`, `403`) oder auf unserer Seite fehlschlagen (`500`). Das Kontingent wird in diesen Fällen zurückgegeben.
- Abgelehnte Anfragen selbst. Sie werden separat als `rejected` erfasst, damit du siehst, was du verpasst hast.

> **Warning: Gelöschte Nachrichten geben kein Kontingent frei**
>
> Der Zähler erfasst gesendete Nachrichten, nicht gespeicherte. Wenn du Nachrichten löschst, einzeln oder alle auf einmal, bekommst du das heutige Kontingent nicht zurück.

## Wenn das Limit erreicht ist

Die API antwortet mit `429 Too Many Requests` und einem `Retry-After`-Header, der die Sekunden bis zum Reset angibt:

```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: 429 in deiner Integration behandeln**
>
> Behandle `429` als „jetzt nicht“ und nicht als vorübergehenden Fehler. Ein Wiederholungsversuch vor Ablauf von `Retry-After` bekommt dieselbe Antwort: Jeder Versuch wird abgelehnt und gezählt. Warte entweder bis `resets_at`, oder verwirf die Benachrichtigung und protokolliere sie.

> **Warning: `curl --retry` kann bis Mitternacht hängen bleiben**
>
> `curl --retry` behandelt `429` als wiederholbar und berücksichtigt `Retry-After`. Ein Skript, das über das Limit hinaus wiederholt, wartet deshalb bis 00:00 UTC. Begrenze die Wartezeit mit `--retry-max-time`:
>
> ```bash
> curl --retry 3 --retry-max-time 60 -X POST "https://api.pocketalert.app/v1/messages" ...
> ```

### Webhooks

Webhook-Aufrufe über dem Limit werden mit demselben `429` abgelehnt. Jeder dieser Aufrufe wird aber trotzdem im [Verlauf](https://info.pocketalert.app/api/webhooks/history.md) des Webhooks gespeichert, mit der vollständigen Payload und der Nachricht, die er erzeugt hätte. Der Eintrag hat `status: "error"` und `error_code: "daily_limit"`. So geht nichts spurlos verloren: Im Verlauf siehst du, was während der Überschreitung eingegangen ist.

## Rate-Limit-Header

Jede erfolgreiche `POST /v1/messages`-Anfrage (und jeder Webhook-Aufruf, der eine Nachricht erstellt) enthält das aktuelle Kontingent:

| Header | Bedeutung |
|--------|-----------|
| `X-PA-Daily-Limit` | Nachrichten pro Tag in deinem Tarif |
| `X-PA-Daily-Remaining` | Nachrichten, die heute noch übrig sind, nach dieser hier |
| `X-PA-Daily-Reset` | Unix-Zeitstempel (Sekunden) des nächsten Resets, 00:00 UTC |

Unbegrenzte Tarife erhalten diese Header nicht.

## E-Mails

Pocket Alert schickt dem Kontoinhaber pro Tag höchstens zwei E-Mails:

- **Bei 80 %** des Tageslimits: ein Hinweis, solange noch Luft ist.
- **Bei der ersten abgelehnten Nachricht**: Das Limit ist erreicht und neue Nachrichten werden abgelehnt.

Unbegrenzte Tarife erhalten diese E-Mails nie.

## Upgrade

Ein neuer Tarif gilt sofort: Sobald das Upgrade abgeschlossen ist, wird die nächste Anfrage gegen das neue Limit geprüft. Du musst nicht auf den Reset warten. Siehe [Preise](https://pocketalert.app/pricing).

## Siehe auch

- [Nachricht erstellen](https://info.pocketalert.app/api/messages/create.md): die `429`-Antwort im Kontext
- [Nachrichtennutzung](https://info.pocketalert.app/api/messages/usage.md): die heutige Nutzung über die API
- [Webhook-Verlauf](https://info.pocketalert.app/api/webhooks/history.md): wo abgelehnte Webhook-Aufrufe aufbewahrt werden
- [Geplanter Versand](https://info.pocketalert.app/features/scheduled-delivery.md): wie geplante Nachrichten gezählt werden
