Skip to main content

HTTP Status Codes

CodeMeaning
200Event accepted
400Invalid or inactive site_id / bad request
401Missing API key
403Invalid API key or unauthorized site
422Validation error
429Rate limit exceeded

Rate Limits

From backend defaults:
  • Browser collection: 100/min (per IP)
  • Server events: 1000/min (per API key)
Burst handling may allow short spikes. Design clients to back off on 429.

Error Handling Pattern

  • Log request id + event id
  • Retry transient errors with exponential backoff
  • Do not retry auth/validation errors until corrected