Blacklist
Esta página contém uma explicação da política de bloqueio da API do Koncili.
O sistema de blacklist é acionado quando um integrador viola repetidamente as políticas de uso da API, especialmente através de requisições com erros consistentes.
Sistema de bloqueio em etapas
Nossa API implementa bloqueios progressivos para dar oportunidades de correção:
1. Bloqueio temporário de 1 hora
- Gatilho: 500+ requisições com erro 4xx dentro de 1 hora
- Status HTTP:
423 Locked
2. Bloqueio permanente
- Gatilho: 1000+ requisições durante bloqueio temporário ativo
- Status HTTP:
423 Locked - Liberação: Requer ação manual da equipe Koncili
Comportamento durante bloqueio
Qualquer requisição durante períodos de bloqueio:
- Será rejeitada com status
423 Locked - Pode agravar a sanção (ex.: converter bloqueio temporário em permanente)
Como evitar a blacklist
Recomendações para tratamento de erros:
- Ao receber erros
4xx, interrompa temporariamente o envio de novas requisições até identificar e corrigir a causa. - Implemente tratamento específico para lidar com bloqueios temporários.
- Analise os payloads que ocasionaram erros
4xxpara realizar os devidos ajustes e evitar recorrências.