Fehler 429 (Rate-Limit)

DeepL begrenzt die Anzahl der Anfragen pro Zeiteinheit. Bei Überschreitung antwortet die API mit HTTP 429 (“Too Many Requests”) und einem Retry-After-Header, der die empfohlene Wartezeit angibt.

Verhalten des Plugins

• Automatischer Retry: bis zu 3 weitere Versuche pro Text
• Die von DeepL mitgeteilte Wartezeit (Retry-After-Header) wird berücksichtigt; ohne Header wird 5 Sekunden gewartet
• Danach schlägt der Job fehl und die Fehlermeldung (inkl. “429”) erscheint in der Queue-Ansicht

Was tun bei häufigen 429-Fehlern?

1. Kontingent prüfen: Unter Inhalte > Übersetzung mit DeepL > DeepL Usage sehen Sie den Verbrauch. Bei erschöpftem Kontingent helfen keine Retries, siehe FAQ: Free vs. Pro.
2. Job-Größe reduzieren: Große Läufe über mehrere Zeitpunkte verteilen (z.B. erst Produkte, dann Kategorien) oder Filters/Whitelists nutzen.
3. Cache nutzen: Ohne “Cache ignorieren” verbrauchen wiederkehrende Texte kein Kontingent, siehe FAQ: Cache.
4. Worker drosseln: Shopware erlaubt die Begrenzung der Worker-Parallelität über die Message-Queue-Konfiguration, siehe Shopware-Doku: Message Queue.
5. Erneut ausführen: Fehlgeschlagene Jobs lassen sich über die Queue-Ansicht einzeln oder massiv erneut einreihen; bereits gecachte Texte laufen dann schnell durch.