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

  1. Lidar com Erros de Limite de Taxa: Implemente um tratamento de erro adequado para operações com limite de taxa
  2. Retrocesso Exponencial: Use retrocesso exponencial ao re-tentar solicitações com limite de taxa
  3. 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.

Assistente de IA

As respostas são geradas usando IA e podem conter erros.

Como posso ajudá-lo?

Pergunte-me qualquer coisa sobre o Blue ou esta documentação.

Digite para enviar • Shift+Enter para nova linha • ⌘I para abrir