Rate Limiting

Die API setzt eine Rate-Limitierung ein, um stabile Performance für alle Nutzer zu gewährleisten. Verwendet wird ein Sliding-Window-Algorithmus, der Anfragen innerhalb eines gleitenden Zeitfensters zählt.

---

Funktionsweise

Der Sliding-Window-Algorithmus berechnet dynamisch, wie viele Anfragen du innerhalb des letzten Zeitfensters gesendet hast. Anders als bei festen Zeitfenstern gibt es keinen harten Reset – ältere Anfragen fallen kontinuierlich aus dem Fenster heraus.

---

Limits nach Nutzergruppe

Nutzergruppe	Anfragen pro Minute
Ohne validen Token	50
Standard Reseller	1.000
Mittelgroße Reseller	5.000
Große Reseller	100.000

Ohne gültigen Token in der Anfrage gilt das niedrigste Limit von 50 Anfragen/Minute.

---

Fehlercode bei Überschreitung

Bei Überschreitung des Limits antwortet die API mit HTTP 429 und dem Fehlercode 42901:

{
    "requestId": 0,
    "data": [],
    "status": "error",
    "messages": {
        "errors": [
            {
                "code": 42901,
                "message": "Rate limit exceeded"
            }
        ]
    }
}

---

Best Practices

• Caching nutzen – Reduziere wiederholte Anfragen für gleichbleibende Daten
• Exponentielles Backoff – Bei 429-Antworten schrittweise länger warten bevor du erneut anfragst
• Bulk-Endpoints bevorzugen – Weniger Einzelanfragen, mehr Daten pro Request

---

Individuelle Limits

Falls dein Unternehmen höheren API-Traffic benötigt, können individuelle Limits vereinbart werden. Kontaktiere dafür das Vertriebsteam.