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
- Fehler bei Ratenlimits behandeln: Implementieren Sie eine ordnungsgemäße Fehlerbehandlung für ratenbegrenzte Operationen
- Exponentieller Rückoff: Verwenden Sie exponentiellen Rückoff beim Wiederholen von ratenbegrenzten Anfragen
- 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.