Skip to main content

​
Rate Limits

LeuwongRR User API memakai rate limit untuk menjaga layanan tetap aman, stabil, dan nyaman digunakan oleh semua member. Rate limit membantu mencegah:
  • Spam request
  • Penyalahgunaan API token
  • Bot yang melakukan request terlalu sering
  • Beban server berlebihan
  • Akses mencurigakan dari sistem eksternal
Rate limit berlaku untuk request public safe endpoint dan User API Token yang dibuat dari halaman https://leuwongrr.online/user/api-access.

​
Batas request user API

Untuk penggunaan normal, batas berikut aman untuk website, bot, atau dashboard sederhana.
Jenis limitBatas rekomendasi
Public read endpoint60 request / menit
User read endpoint60 request / menit
Create order endpoint10 request / menit
Token validate endpoint30 request / menit
Request paralelMaksimal 2–3 request bersamaan
Token lewat URLTidak diizinkan
Token lewat headerWajib
Jangan polling setiap 1 detik. Request terlalu agresif dapat terkena 429 Too Many Requests.

​
Endpoint yang dihitung rate limit

GET  /api/v1/health
POST /api/v1/auth/token/validate
GET  /api/v1/catalog/robux-packages
GET  /api/v1/catalog/payment-methods
GET  /api/v1/articles
GET  /api/v1/articles/{slug}
GET  /api/v1/me
GET  /api/v1/me/dashboard-summary
GET  /api/v1/me/balance
GET  /api/v1/me/balance/transactions
GET  /api/v1/me/deposits
GET  /api/v1/me/deposits/{invoice}
POST /api/v1/me/orders
GET  /api/v1/me/orders
GET  /api/v1/me/orders/{invoice}
GET  /api/v1/me/invoices/{invoice}
GET  /api/v1/me/invoices/{invoice}/status

​
Response jika terkena rate limit

Jika request terlalu sering, API dapat mengembalikan: 
429 Too Many Requests
Contoh response: 
{
  "success": false,
  "message": "Terlalu banyak request. Silakan coba lagi beberapa saat."
}

​
Header rate limit

Jika tersedia, response API dapat menyertakan header berikut:
HeaderKeterangan
Retry-AfterWaktu tunggu dalam detik sebelum mencoba lagi
X-RateLimit-LimitBatas request periode saat ini
X-RateLimit-RemainingSisa request yang masih tersedia
X-RateLimit-ResetWaktu reset limit dalam Unix timestamp
Contoh: 
Retry-After: 30
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1760000000
Jika menerima status 429, tunggu sesuai nilai Retry-After sebelum mencoba lagi.

​
Rekomendasi interval request

KebutuhanRekomendasi
Cek status invoiceSetiap 10–30 detik
Cek daftar orderSetiap 30–60 detik
Cek saldoSaat halaman dibuka atau setiap 30–60 detik
Cek profil /meSaat login / saat halaman dibuka
Bot command manualSaat user menjalankan command
Auto refresh dashboardMinimal 15–30 detik

​
Cara retry yang aman

Gunakan exponential backoff sederhana: 
async function fetchWithRetry(url, options, retries = 3) {
  for (let attempt = 0; attempt <= retries; attempt++) {
    const response = await fetch(url, options);

    if (response.status !== 429) {
      return response;
    }

    const retryAfter = Number(response.headers.get('Retry-After') || 5);
    await new Promise((resolve) => setTimeout(resolve, retryAfter * 1000));
  }

  throw new Error('Rate limit exceeded. Please try again later.');
}

​
Praktik terbaik

  • Simpan token di backend/server/bot
  • Jangan simpan token di frontend JavaScript
  • Jangan upload token ke GitHub
  • Gunakan HTTPS
  • Gunakan cache ringan untuk data yang sering dibaca
  • Hindari request berulang terlalu cepat
  • Regenerate token jika dicurigai bocor