Copy page

Pola Umum

Batas Rate (Rate Limit)

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

Batas

API mengizinkan 60 permintaan per 60 detik, per API key.

Secara terpisah, setiap organisasi memiliki kuota permintaan bulanan berdasarkan paketnya. Melebihi kuota bulanan mengembalikan 403 Forbidden.

Header batas rate

Header X-RateLimit-* dikembalikan hanya pada respons 429 (bukan pada permintaan yang berhasil):

Header	Deskripsi
X-RateLimit-Limit	Maksimum permintaan dalam jendela
X-RateLimit-Remaining	Permintaan tersisa dalam jendela
X-RateLimit-Reset	Stempel waktu Unix saat jendela direset
Retry-After	Detik untuk menunggu sebelum mencoba lagi

Menangani batas rate

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

Code
{
  "success": false,
  "message": "Too many requests. Please retry after 42 seconds.",
  "retryAfter": 42
}

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

• Hormati Retry-After pada respons 429 untuk mengetahui persis berapa lama harus menunggu
• 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

Catatan: header batas rate hanya ada pada respons 429, jadi Anda tidak dapat membaca kuota tersisa dari permintaan yang berhasil.

Langkah selanjutnya

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