Skip to content

🚀 API Rate Limitierung

Um eine stabile und faire Nutzung der FameSystems Reseller API zu gewährleisten, setzen wir eine Rate-Limitierung ein.
Wir verwenden den Sliding Window Algorithmus, um Anfragen effizient zu begrenzen und Missbrauch zu vermeiden.


🛠 Was ist der Sliding Window Algorithmus?

Der Sliding Window Algorithmus ist eine dynamische Methode zur Überwachung der API-Anfragen innerhalb eines bestimmten Zeitraums.
Anstatt eine harte Grenze zu setzen, erlaubt der Algorithmus eine gleitende Berechnung, bei der ältere Anfragen aus dem Zeitfenster entfernt werden.

🔹 Vorteile des Sliding Window Algorithmus:
✅ Verhindert plötzliche Sperren durch natürliche Verteilung von Anfragen
✅ Erlaubt kontinuierliche Nutzung ohne harte Reset-Zeiten
Effiziente Ressourcen-Nutzung, ohne legitime Nutzer zu blockieren

Sliding Window Algorithmus


📌 API Rate Limits nach Nutzergruppe

Je nach API-Nutzung gibt es verschiedene Rate Limits, die verhindern, dass einzelne Nutzer das System überlasten.

Nutzergruppe Rate Limit (Anfragen pro Minute)
Ohne validen API-Token 50
🟢 Standard Reseller 1.000
🔵 Mittelgroße Reseller 5.000
🔴 Große Reseller 100.000

Falls du kein gültiges Token in der Anfrage mitsendest, gilt das niedrigste Rate Limit von 50 Anfragen pro Minute.


❌ Fehlercode bei Erreichen des Limits

Wenn dein System das Rate Limit überschreitet, erhältst du den HTTP-Statuscode 42901 Too Many Requests und folgende API-Fehlermeldung:

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

📌 Lösung: Warte einige Sekunden, bevor du weitere Anfragen sendest.

Falls dein System ein höheres Limit benötigt, kannst du uns gerne kontaktieren.


📞 Individuelle Rate Limits

Falls dein Unternehmen einen höheren API-Traffic benötigt, bieten wir individuelle Anpassungen an.
Kontaktiere unser Vertriebsteam für ein maßgeschneidertes Rate Limit:

📧 Vertrieb kontaktieren


🚀 Best Practices zur Vermeidung von Rate Limits

🔹 Vermeide unnötige API-Calls – Nutze Caching, um wiederholte Anfragen zu reduzieren
🔹 Implementiere eine Retry-Logik – Falls du eine 42901-Fehlermeldung erhältst, warte einige Sekunden, bevor du erneut anfragst
🔹 Nutze Webhooks, um Statusänderungen zu empfangen, anstatt regelmäßig abzufragen

Durch eine effiziente Nutzung der API stellst du sicher, dass dein System reibungslos und schnell läuft! 🚀