Batas Rate (Rate Limit)

API Qwetty menerapkan batas rate untuk memastikan penggunaan yang adil dan stabilitas sistem.

Batas

Batas rate diterapkan per API key.

Header batas rate

Setiap respons menyertakan informasi batas rate:

Menangani batas rate

Ketika Anda melebihi batas, API mengembalikan 429 Too Many Requests:

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

Strategi backoff

Terapkan 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');
}

Praktik terbaik

• Pantau permintaan tersisa menggunakan header X-RateLimit-Remaining
• Kelompokkan operasi jika memungkinkan untuk mengurangi jumlah permintaan
• Cache respons untuk data yang tidak sering berubah
• Gunakan webhook alih-alih polling untuk pembaruan real-time

Langkah selanjutnya

• Penanganan Error — Menangani seluruh error API
• Webhook — Notifikasi peristiwa real-time