Linee guida per il limitamento della frequenza dell'API di Blue
In generale, l'API di Blue non applica limiti di frequenza rigidi nella maggior parte delle operazioni. Tuttavia, alcune operazioni sensibili hanno limiti di frequenza specifici per prevenire abusi e garantire la stabilità del sistema.
Operazioni con Limiti di Frequenza
Le seguenti operazioni hanno limiti di frequenza applicati:
Operazione | Limite di Frequenza | Finestra | Scopo |
---|---|---|---|
signIn |
5 requests | 60 seconds | Prevenire attacchi di forza bruta |
signInRequest |
3 requests | 120 seconds | Limitare i tentativi di autenticazione |
createDocument |
5 requests | 60 seconds | Prevenire lo spam di documenti |
sendTestEmail |
5 requests | 60 seconds | Prevenire abusi di email |
submitForm |
5 requests | 60 seconds | Prevenire lo spam nei moduli |
exportTodos |
1 request | 50 seconds | Limitare le esportazioni intensive di risorse |
deleteCompany |
3 requests | 60 seconds | Prevenire eliminazioni accidentali |
deleteCompanyRequest |
3 requests | 60 seconds | Prevenire eliminazioni accidentali |
updateEmail |
3 requests | 60 seconds | Prevenire abusi nel cambio di email |
updateEmailRequest |
3 requests | 60 seconds | Prevenire abusi nel cambio di email |
verifyAcceptInvitation |
3 requests | 60 seconds | Limitare i tentativi di verifica |
verifySecurityCode |
3 requests | 60 seconds | Limitare i tentativi di verifica |
Comportamento del Limite di Frequenza
- Per Utente: I limiti di frequenza sono applicati per ogni utente autenticato
- Per IP: Per le richieste non autenticate, i limiti sono applicati per indirizzo IP
- Nessuna Intestazione: Le informazioni sui limiti di frequenza non sono incluse nelle intestazioni di risposta
Risposta di Errore
Quando un limite di frequenza viene superato, riceverai un errore GraphQL:
{
"errors": [{
"message": "Rate limit exceeded",
"extensions": {
"code": "RATE_LIMITED"
}
}]
}
Migliori Pratiche
- Gestire gli Errori di Limite di Frequenza: Implementare una corretta gestione degli errori per le operazioni con limiti di frequenza
- Ritardo Esponenziale: Utilizzare un ritardo esponenziale quando si riprovano richieste con limiti di frequenza
- Monitorare l'Uso: Essere consapevoli delle operazioni che hanno limiti quando si costruiscono integrazioni
Per domande sui limiti di frequenza, ti preghiamo di contattare il nostro team di supporto.