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

  1. Gestire gli Errori di Limite di Frequenza: Implementare una corretta gestione degli errori per le operazioni con limiti di frequenza
  2. Ritardo Esponenziale: Utilizzare un ritardo esponenziale quando si riprovano richieste con limiti di frequenza
  3. 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.

Assistente AI

Le risposte sono generate utilizzando l'IA e potrebbero contenere errori.

Come posso aiutarti?

Chiedimi qualsiasi cosa su Blue o su questa documentazione.

Invia per inviare • Maiusc+Invio per una nuova riga • ⌘I per aprire