Had Kadar

Memahami dan menguruskan had kadar, kuota harian, dan kadar ledakan API TCG Price Lookup.

Had Kadar Mengikut Pelan

Had harian ditetapkan semula setiap hari pada tengah malam UTC.

Pengepala Had Kadar

Semua respons API termasuk maklumat had kadar semasa:

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

Mengendalikan Ralat 429

Apabila anda melebihi had kadar, 429 Too Many Requests dikembalikan:

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

Gunakan pengepala Retry-After untuk menentukan masa tunggu sebelum permintaan seterusnya:

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;
  }
}

Amalan Terbaik

Gunakan permintaan kelompok (Pelan Trader ke atas):

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

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

Cache respons:

Harga dikemas kini setiap beberapa jam. Cache jangka pendek (5–15 minit) sesuai untuk kebanyakan kes penggunaan:

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

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;
}