models/errors library

Errors raised by the IForevents API integration.

The API answers every failure with {"error": ...}; machine-readable failures also carry a stable code in error and the prose in message (for example quota_exceeded). The integration maps the ones an app can act on to the classes below and treats them as permanent: the affected events are dropped instead of re-queued, because retrying an exhausted quota or a revoked key only burns battery.

Exceptions / Errors

IForeventsAPIException

Base class for API failures.

IForeventsAuthException

The project key was refused (401 unknown or rotated key, 403 disabled project). Permanent until the app ships a valid key.

IForeventsQuotaExceededException

The organization is past its monthly event quota and grace period (429, quota_exceeded). Events sent while this holds are refused by the API; the integration drops them and stops re-queueing until the next call succeeds. Upgrade the plan or wait for the next month.

IForeventsRateLimitedException

Too many requests in a short window (429 without a quota code). The integration retries after retryAfter when retries are enabled and re-queues the events otherwise.