Rate Limits

Nembol verwendet einen Leaky Bucket pro API-Schlüssel (dasselbe Modell wie Shopify): Du kannst kurzzeitig bis zur Bucket-Größe senden, und der Bucket leert sich mit einer konstanten Rate.

Partner: Mit dem Header Nembol-Account hat jedes Unternehmen seinen eigenen Bucket, sodass ein ausgelastetes Unternehmen die anderen nie ausbremst. Seine Größe richtet sich nach dem Plan dieses Unternehmens, nicht nach deinem. Aufrufe ohne den Header (dein eigener Shop, /accounts, /partner/*) nutzen den Bucket des Schlüssels, bemessen nach deinem Plan.

Zusätzlich zum Request-Limit gibt es ein tägliches Schreibkontingent für Requests, die Kanäle verändern (Schreibvorgänge an Produkten, Bestandsaktualisierungen, Veröffentlichen/Delisten), denn jeder Schreibvorgang verbraucht auch die API-Kontingente deiner eigenen Kanäle. Deine aktuelle Nutzung siehst du im Dashboard unter Einstellungen → Entwickler → Nutzung.

Header

Jede Antwort sagt dir, wo du stehst. Nutze die Header, um bevor du 429 erreichst zurückzufahren:

X-RateLimit-Limit: 40
X-RateLimit-Remaining: 12
X-RateLimit-Reset: 1784900412

Remaining gibt an, wie viele Requests gerade passen. Reset ist die Unix-Epoch-Sekunde, zu der der Bucket wieder vollständig gefüllt ist (alle Limit Requests verfügbar), nicht der nächste freie Platz: Direkt nach einem 429 kann das viele Sekunden entfernt sein, während ein einzelner Request bereits wieder passt. Um zu wissen, wann der nächste Request passt, verwende Retry-After aus der 429-Antwort.

Wenn du 429 erreichst

{ "error": { "type": "rate_limit_error", "code": "rate_limit_exceeded", "message": "…" } }

Die Antwort enthält Retry-After (Sekunden, exakt, aus dem Bucket berechnet statt geschätzt). Warte so lange und versuche es erneut. Für dauerhaften Durchsatz taktest du deine Requests mit der dauerhaften Rate, statt in Bursts zu senden und dann zu warten.

write_quota_exceeded (ebenfalls 429) bedeutet, dass das tägliche Schreibkontingent aufgebraucht ist. Es wird um Mitternacht UTC zurückgesetzt; Lesezugriffe funktionieren weiter.

Kanal-Limits zählen mehr als unsere

Jeder Schreibvorgang an Produkten oder Beständen ruft letztlich die APIs deiner Kanäle auf, die eigene (oft viel engere) Limits haben. Nembols Worker halten sie automatisch ein. Wenn ein Kanal drosselt, meldet die Operation channel_rate_limited, und Nembol versucht es mit Backoff erneut. Batch-Endpoints (POST /inventory/batch) sind der effiziente Weg für Massenaktualisierungen: ein API-Request, optimal getaktete Kanalaufrufe.

Zuletzt aktualisiert am 21. Oktober 2026