Diretrizes para limitação de taxa da API Blue
Em geral, a API Blue não impõe limites de taxa rígidos na maioria das operações. No entanto, certas operações sensíveis têm limites de taxa específicos para prevenir abusos e garantir a estabilidade do sistema.
Operações com Limite de Taxa
As seguintes operações têm limites de taxa impostos:
Operação | Limite de Taxa | Janela | Propósito |
---|---|---|---|
signIn |
5 requests | 60 seconds | Prevenir ataques de força bruta |
signInRequest |
3 requests | 120 seconds | Limitar tentativas de autenticação |
createDocument |
5 requests | 60 seconds | Prevenir spam de documentos |
sendTestEmail |
5 requests | 60 seconds | Prevenir abuso de email |
submitForm |
5 requests | 60 seconds | Prevenir spam de formulários |
exportTodos |
1 request | 50 seconds | Limitar exportações intensivas em recursos |
deleteCompany |
3 requests | 60 seconds | Prevenir exclusões acidentais |
deleteCompanyRequest |
3 requests | 60 seconds | Prevenir exclusões acidentais |
updateEmail |
3 requests | 60 seconds | Prevenir abuso na mudança de email |
updateEmailRequest |
3 requests | 60 seconds | Prevenir abuso na mudança de email |
verifyAcceptInvitation |
3 requests | 60 seconds | Limitar tentativas de verificação |
verifySecurityCode |
3 requests | 60 seconds | Limitar tentativas de verificação |
Comportamento do Limite de Taxa
- Por Usuário: Os limites de taxa são aplicados por usuário autenticado
- Por IP: Para solicitações não autenticadas, os limites são aplicados por endereço IP
- Sem Cabeçalhos: As informações sobre limites de taxa não estão incluídas nos cabeçalhos de resposta
Resposta de Erro
Quando um limite de taxa é excedido, você receberá um erro GraphQL:
{
"errors": [{
"message": "Rate limit exceeded",
"extensions": {
"code": "RATE_LIMITED"
}
}]
}
Melhores Práticas
- Lidar com Erros de Limite de Taxa: Implemente um tratamento de erro adequado para operações com limite de taxa
- Retrocesso Exponencial: Use retrocesso exponencial ao re-tentar solicitações com limite de taxa
- Monitorar Uso: Esteja ciente de quais operações têm limites ao construir integrações
Para perguntas sobre limites de taxa, por favor entre em contato com nossa equipe de suporte.