API-Rate-Limits

Token-Bucket pro Schlüssel

Jeder API-Schlüssel verfügt über einen Token-Bucket mit einem Burst von 60 Token und einer Auffüllrate von 1 Token pro Sekunde. Lesevorgänge kosten 1 Token. Schreibvorgänge kosten 2 Token.

Das Erstellen einer Produkt-Update-Benachrichtigung (POST /products/{shopify_product_id}/notifications, Probelauf inklusive) kostet 10 Token. Das Flag notify_customers bei einem Schreibvorgang für eine Zuordnung kostet nichts zusätzlich: Dieser Schreibvorgang kostet wie üblich 2 Token, ob er eine Benachrichtigung anfordert oder nicht. Das 7-Tage-Limit von einer Benachrichtigung pro Produkt ist eine separate Regel mit eigenem Code, 429 notification_cooldown: Ihr Retry-After kann bis zu sieben Tage betragen, wiederholen Sie sie also nicht automatisch — planen Sie den nächsten Aufruf für error.details.next_available_at.

Ein Shop kann außerdem höchstens 5 Produkt-Update-Benachrichtigungen gleichzeitig haben, die warten oder senden. Eine sechste ist 429 too_many_active_notifications, eine dritte Art von 429 neben rate_limited und notification_cooldown — unterscheiden Sie sie also anhand von error.code, nicht anhand des Status. Sie hat kein Retry-After: Fragen Sie GET /notifications/{id} für eine der error.details.active_notification_ids regelmäßig ab und versuchen Sie es erneut, sobald diese Kampagne abgeschlossen ist.

Wenn das Limit überschritten wird, gibt die API 429 rate_limited zurück.

Rate-Limit-Header

Retry-After: 12
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 2026-06-05T12:00:00.000Z

Warten Sie vor einem erneuten Versuch mindestens die in Retry-After angegebene Dauer ab. Verwenden Sie denselben Idempotency-Key, wenn Sie denselben Schreibvorgang erneut versuchen.

Limit für erneuten E-Mail-Versand

Der Endpunkt zum erneuten Versenden von Bestellungen hat ein zusätzliches Sicherheitslimit von 3 erneuten Versandanfragen pro Stunde und Bestellung.