Mengenbegrenzung

Die API begrenzt die Anfragen pro Minute, damit eine fehlerhafte Schleife nicht andere Händler beeinträchtigt.

Wie gezählt wird

• Pro Schlüssel. Jeder gültige API-Schlüssel hat ein eigenes Budget. Mehrere Integrationen hinter derselben IP-Adresse teilen sich also kein Budget.
• Zusätzlich pro IP-Adresse gilt eine höhere Obergrenze über alle Schlüssel dieser Quelle.
• Fenster: 60 Sekunden.

Derzeit gilt ein Budget von 300 Anfragen pro Minute und Schlüssel. Shirtee kann diesen Wert ohne Ankündigung ändern. Verlasse dich auf die Header, nicht auf die Zahl.

Header

Jede Antwort trägt die Header zur Mengenbegrenzung, auch ein 401 und ein 429:

Header	Bedeutung	Beispiel
RateLimit-Policy	Budget und Fenster	300; w=60
RateLimit-Limit	Anfragen pro Fenster	300
RateLimit-Remaining	Verbleibende Anfragen	298
RateLimit-Reset	Sekunden bis zum Zurücksetzen	48

Bei 429

Du hast das Budget aufgebraucht. Warte mindestens RateLimit-Reset Sekunden und wiederhole dann. Es gibt keinen Retry-After-Header.

wenn RateLimit-Remaining klein:  langsamer senden
bei 429:                         RateLimit-Reset Sekunden warten, dann erneut
bei 429 trotz Wartezeit:         Wartezeit verdoppeln (Backoff), Obergrenze setzen

Weniger Anfragen brauchen

• Nutze Filter und Seitenwerte der Listen, statt jede Ressource einzeln abzufragen.
• Frage Status nicht dichter ab als nötig, siehe Status abfragen statt Webhooks.
• Speichere Katalogdaten, die sich selten ändern, bei dir zwischen.