Rate Limiting

Memahami dan mengelola rate limit, kuota harian, dan burst rate di TCG Price Lookup API.

Rate Limit per Paket

Batas harian direset setiap hari pada tengah malam UTC.

Header Rate Limit

Setiap respons API menyertakan informasi rate limit saat ini:

X-RateLimit-Limit: 200
X-RateLimit-Remaining: 150
X-RateLimit-Reset: 1704067200

Menangani Error 429

Saat rate limit terlampaui, 429 Too Many Requests dikembalikan:

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Daily request limit reached. Resets at midnight UTC."
  }
}

Gunakan header Retry-After untuk mengetahui berapa lama menunggu sebelum permintaan berikutnya:

async function fetchWithRetry(url, options, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    const response = await fetch(url, options);
    
    if (response.status === 429) {
      const retryAfter = parseInt(response.headers.get('retry-after') || '60');
      await new Promise(r => setTimeout(r, retryAfter * 1000));
      continue;
    }
    
    return response;
  }
}

Praktik Terbaik

Gunakan permintaan batch (Paket Trader ke atas):

// Tidak efisien: 20 permintaan individual
for (const id of cardIds) {
  await tcg.cards.get(id); // ✗
}

// Efisien: 1 permintaan batch
const cards = await tcg.cards.batch(cardIds); // ✓

Cache respons:

Harga diperbarui setiap beberapa jam. Cache jangka pendek (5–15 menit) sesuai untuk sebagian besar kasus penggunaan:

const cache = new Map();
const CACHE_TTL = 5 * 60 * 1000; // 5 menit

async function getCachedCard(id) {
  const cached = cache.get(id);
  if (cached && Date.now() - cached.timestamp < CACHE_TTL) {
    return cached.data;
  }
  const data = await tcg.cards.get(id);
  cache.set(id, { data, timestamp: Date.now() });
  return data;
}