🚀 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

📌 API Rate Limits nach Nutzergruppe

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

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! 🚀