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. Außerdem kannst du sie über die API abrufen: GET /v1/messages/usage.
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, 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
rejectederfasst, damit du siehst, was du verpasst hast.
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/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"
}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.
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:
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 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.
Siehe auch
- Nachricht erstellen: die
429-Antwort im Kontext - Nachrichtennutzung: die heutige Nutzung über die API
- Webhook-Verlauf: wo abgelehnte Webhook-Aufrufe aufbewahrt werden
- Geplanter Versand: wie geplante Nachrichten gezählt werden