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 limit	Batas rekomendasi
Public read endpoint	60 request / menit
User read endpoint	60 request / menit
Create order endpoint	10 request / menit
Token validate endpoint	30 request / menit
Request paralel	Maksimal 2–3 request bersamaan
Token lewat URL	Tidak diizinkan
Token lewat header	Wajib

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:

Header	Keterangan
`Retry-After`	Waktu tunggu dalam detik sebelum mencoba lagi
`X-RateLimit-Limit`	Batas request periode saat ini
`X-RateLimit-Remaining`	Sisa request yang masih tersedia
`X-RateLimit-Reset`	Waktu 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

Kebutuhan	Rekomendasi
Cek status invoice	Setiap 10–30 detik
Cek daftar order	Setiap 30–60 detik
Cek saldo	Saat halaman dibuka atau setiap 30–60 detik
Cek profil `/me`	Saat login / saat halaman dibuka
Bot command manual	Saat user menjalankan command
Auto refresh dashboard	Minimal 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

Mulai di Sini

API Reference

Endpoint Publik Aman

Endpoint User API

Rate Limits

Rate Limits

Batas request user API

Endpoint yang dihitung rate limit

Response jika terkena rate limit

Header rate limit

Rekomendasi interval request

Cara retry yang aman

Praktik terbaik

​Rate Limits

​Batas request user API

​Endpoint yang dihitung rate limit

​Response jika terkena rate limit

​Header rate limit

​Rekomendasi interval request

​Cara retry yang aman

​Praktik terbaik

Rate Limits

Batas request user API

Endpoint yang dihitung rate limit

Response jika terkena rate limit

Header rate limit

Rekomendasi interval request

Cara retry yang aman

Praktik terbaik