API e Webhooks
Limites & Rate Policy
3 min
para garantir a estabilidade da plataforma e evitar abusos em ambientes de alta concorrência, o safia square implementa uma política de controle de requisições por chave de api e tipo de recurso políticas aplicadas 1\ rate limit padrão (por ip e token) 60 requisições por minuto para endpoints de leitura 30 requisições por minuto para endpoints de escrita 10 requisições por minuto para autenticação 2\ burst control requisições em sequência são limitadas a 10 por segundo detecção de chamadas duplicadas em menos de 500ms 3\ webhooks tolerância a 3 falhas consecutivas antes de pausa automática reenvio com backoff exponencial por até 24h 4\ penalidades bloqueio temporário por excesso reiterado log detalhado de bloqueios disponível no painel administrativo 5\ customização limites ajustáveis para clientes com volume elevado, mediante acordo técnico e autenticação reforçada todos os limites são visíveis via cabeçalhos de resposta (x ratelimit limit, x ratelimit remaining, retry after) e acompanhados por métricas nos dashboards técnicos da plataforma
