Skip to main content

Blacklist

This page explains the blocking policies for the Koncili API.

The blacklist system is triggered when an integrator repeatedly violates API usage policies, specifically through consistent request errors.

Progressive Blocking System​

Our API implements progressive tiers of blocking to allow for technical corrections:

1. 1-Hour Temporary Block​

  • Trigger: 500+ requests resulting in 4xx errors within a 1-hour window.
  • HTTP Status: 423 Locked

2. Permanent Block​

  • Trigger: 1,000+ additional requests while a temporary block is active.
  • HTTP Status: 423 Locked
  • Resolution: Requires manual intervention and review by the Koncili support team.
Behavior During Blocked Periods

Any request made during a block:

  • Will be rejected with an HTTP 423 Locked status.
  • May escalate the restriction (e.g., upgrading a temporary block to a permanent one).

Best Practices to avoid Blacklisting​

Recommendations for error handling and data integrity:

  • Upon receiving 4xx errors, temporarily suspend new requests until the root cause is identified and resolved.
  • Implement specific logic to handle temporary blocks gracefully.
  • Analyze payloads that result in 4xx errors to make necessary adjustments and prevent recurrence.