Aller au contenu principal

Rate Limits

Ikawaari enforces rate limits to ensure fair usage and platform stability.

Default Limits​

ScopeLimit
Per API key100 requests/minute (configurable)
Per merchant (all keys)1,000 requests/minute
Webhook test events10 requests/minute

Rate Limit Headers​

Every API response includes rate limit headers:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 1708300860

When You Hit the Limit​

You'll receive a 429 Too Many Requests response:

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests. Please retry after 12 seconds.",
    "type": "api_error"
  }
}

Best Practices​

  • Implement exponential backoff for retries
  • Cache responses where possible
  • Use webhooks instead of polling for status updates
  • Request a limit increase if you need higher throughput — contact support@ikawaari.com