Errors
Connect API error codes and handling.
| Code | HTTP | Meaning | Action |
|---|---|---|---|
THROTTLED | 429 | Rate limit exceeded | Backoff; respect Retry-After |
UNAUTHORIZED | 401 | Invalid or missing key | Check ev_live_* env var |
QUOTA_EXCEEDED | 429 | Monthly API quota | Upgrade offer or wait for cycle |
FORBIDDEN | 403 | Path not allowed (docs BFF) | Use allowlisted public paths only |
| Pagination error | 400 | Invalid cursor/offset | Use keyset cursors for large feeds |
Docs BFF
Browser requests to /api/connect/* are rate limited to 30/min/IP. Prefer embeds over scraping.
Deprecated key
During key rotation overlap:
X-Eventyvo-Connect-Key-Deprecated: true
Update your server key promptly.