Rate Limits

The Qwetty API enforces rate limits to ensure fair usage and system stability.

Limits

Rate limits are applied per API key.

Rate limit headers

Every response includes rate limit information:

Handling rate limits

When you exceed the limit, the API returns 429 Too Many Requests:

Code
{
  "success": false,
  "message": "Rate limit exceeded"
}

Backoff strategy

Implement exponential backoff:

Code
async function requestWithBackoff(url, options, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    const response = await fetch(url, options);
    if (response.status !== 429) return response;

    const resetTime = response.headers.get('X-RateLimit-Reset');
    const waitMs = resetTime
      ? (parseInt(resetTime) * 1000) - Date.now()
      : Math.pow(2, i) * 1000;

    await new Promise(resolve => setTimeout(resolve, waitMs));
  }
  throw new Error('Rate limit exceeded after retries');
}

Best practices

• Monitor remaining requests using the X-RateLimit-Remaining header
• Batch operations where possible to reduce request count
• Cache responses for data that doesn't change frequently
• Use webhooks instead of polling for real-time updates

Next steps

• Error Handling — Handle all API errors
• Webhooks — Real-time event notifications