Zum Inhalt springen

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 ​

TarifNachrichten pro Tag
Free50
Starter1.000
Medium5.000
LargeUnbegrenzt

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 rejected erfasst, 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
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"
}

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:

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 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:

HeaderBedeutung
X-PA-Daily-LimitNachrichten pro Tag in deinem Tarif
X-PA-Daily-RemainingNachrichten, die heute noch übrig sind, nach dieser hier
X-PA-Daily-ResetUnix-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 ​

Pocket Alert Dokumentation