Rate Limiting

Κατανόηση και διαχείριση των ορίων ρυθμού, των ημερήσιων ποσοστώσεων και των ρυθμών burst στο TCG Price Lookup API.

Όρια ρυθμού ανά πλάνο

Τα ημερήσια όρια επαναφέρονται κάθε μέρα στα μεσάνυχτα UTC.

Κεφαλίδες rate limit

Κάθε απόκριση API περιλαμβάνει πληροφορίες για το τρέχον rate limit:

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

Διαχείριση σφαλμάτων 429

Όταν υπερβείτε το rate limit, επιστρέφεται 429 Too Many Requests:

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

Χρησιμοποιήστε την κεφαλίδα Retry-After για να υπολογίσετε τον χρόνο αναμονής:

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

Βέλτιστες πρακτικές

Χρησιμοποιήστε μαζικά αιτήματα (πλάνο Trader ή ανώτερο):

// Αναποτελεσματικό: 20 ξεχωριστά αιτήματα
for (const id of cardIds) {
  await tcg.cards.get(id); // ✗
}

// Αποτελεσματικό: 1 μαζικό αίτημα
const cards = await tcg.cards.batch(cardIds); // ✓

Αποθηκεύστε αποκρίσεις στην κρυφή μνήμη:

Οι τιμές ενημερώνονται κάθε λίγες ώρες. Βραχυπρόθεσμη αποθήκευση στην κρυφή μνήμη (5-15 λεπτά) είναι κατάλληλη για τις περισσότερες περιπτώσεις χρήσης:

const cache = new Map();
const CACHE_TTL = 5 * 60 * 1000; // 5 λεπτά

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