Blacklist
Esta página contiene una explicación de la política de bloqueo de la API de Koncili.
El sistema de blacklist se activa cuando un integrador infringe repetidamente las políticas de uso de la API, especialmente mediante solicitudes con errores constantes.
Sistema de bloqueo por etapas
Nuestra API implementa bloqueos progresivos para dar oportunidades de corrección:
1. Bloqueo temporal de 1 hora
- Disparador: 500 o más solicitudes con error 4xx dentro de 1 hora
- Estado HTTP:
423 Locked
2. Bloqueo permanente
- Disparador: 1000 o más solicitudes durante un bloqueo temporal activo
- Estado HTTP:
423 Locked - Liberación: Requiere acción manual del equipo de Koncili
Comportamiento durante el bloqueo
Cualquier solicitud durante los períodos de bloqueo:
- Será rechazada con el estado
423 Locked - Puede agravar la sanción (p. ej.: convertir un bloqueo temporal en permanente)
Cómo evitar la blacklist
Recomendaciones para el manejo de errores:
- Al recibir errores
4xx, interrumpe temporalmente el envío de nuevas solicitudes hasta identificar y corregir la causa. - Implementa un manejo específico para lidiar con los bloqueos temporales.
- Analiza los payloads que causaron errores
4xxpara hacer los ajustes necesarios y evitar recurrencias.