Richtlinien für die Ratenbegrenzung der Blue API


Im Allgemeinen setzt die Blue API keine strengen Ratenlimits für die meisten Operationen durch. Bestimmte sensible Operationen haben jedoch spezifische Ratenlimits, um Missbrauch zu verhindern und die Systemstabilität zu gewährleisten.

Ratenbegrenzte Operationen

Die folgenden Operationen haben durchgesetzte Ratenlimits:

Operation Ratenlimit Zeitraum Zweck
signIn 5 requests 60 seconds Brute-Force-Angriffe verhindern
signInRequest 3 requests 120 seconds Authentifizierungsversuche begrenzen
createDocument 5 requests 60 seconds Dokumentenspam verhindern
sendTestEmail 5 requests 60 seconds E-Mail-Missbrauch verhindern
submitForm 5 requests 60 seconds Formularspam verhindern
exportTodos 1 request 50 seconds Ressourcenintensive Exporte begrenzen
deleteCompany 3 requests 60 seconds Unabsichtliche Löschungen verhindern
deleteCompanyRequest 3 requests 60 seconds Unabsichtliche Löschungen verhindern
updateEmail 3 requests 60 seconds Missbrauch bei E-Mail-Änderungen verhindern
updateEmailRequest 3 requests 60 seconds Missbrauch bei E-Mail-Änderungen verhindern
verifyAcceptInvitation 3 requests 60 seconds Authentifizierungsversuche begrenzen
verifySecurityCode 3 requests 60 seconds Authentifizierungsversuche begrenzen

Verhalten der Ratenbegrenzung

  • Pro Benutzer: Ratenlimits werden pro authentifiziertem Benutzer angewendet
  • Pro IP: Für nicht authentifizierte Anfragen werden Limits pro IP-Adresse angewendet
  • Keine Header: Informationen zu Ratenlimits sind nicht in den Antwort-Headern enthalten

Fehlerantwort

Wenn ein Ratenlimit überschritten wird, erhalten Sie einen GraphQL-Fehler:

{
  "errors": [{
    "message": "Rate limit exceeded",
    "extensions": {
      "code": "RATE_LIMITED"
    }
  }]
}

Best Practices

  1. Fehler bei Ratenlimits behandeln: Implementieren Sie eine ordnungsgemäße Fehlerbehandlung für ratenbegrenzte Operationen
  2. Exponentieller Rückoff: Verwenden Sie exponentiellen Rückoff beim Wiederholen von ratenbegrenzten Anfragen
  3. Nutzung überwachen: Seien Sie sich bewusst, welche Operationen Limits haben, wenn Sie Integrationen erstellen

Bei Fragen zu Ratenlimits wenden Sie sich bitte an unser Support-Team.

KI-Assistent

Antworten werden mit KI generiert und können Fehler enthalten.

Wie kann ich Ihnen helfen?

Fragen Sie mich alles über Blue oder diese Dokumentation.

Eingabe zum Senden • Shift+Eingabe für neue Zeile • ⌘I zum Öffnen