Estrategia de cache e polling

Cache and polling strategy guide

Otimizar o uso de chamadas da API e fundamental para evitar rate limits e reduzir custos. Neste guia veremos os intervalos recomendados por tipo de dado.

Optimizing API call usage is essential to avoid rate limits and reduce costs. In this guide we'll cover the recommended polling intervals by data type.

1. Cache CDN por endpoint / CDN cache per endpoint

A API usa Bunny CDN com TTLs diferentes por endpoint. O browser recebe no maximo 30s de cache para dados da API (imagens recebem 7 dias). A tabela abaixo mostra o cache no CDN (s-maxage):

The API uses Bunny CDN with different TTLs per endpoint. The browser gets at most 30s cache for API data (images get 7 days). The table below shows CDN cache (s-maxage):

2. Padrao de polling com cleanup / Polling pattern with cleanup

class Poller {
  constructor(fetchFn, intervalMs) {
    this.fetchFn = fetchFn;
    this.intervalMs = intervalMs;
    this.timer = null;
    this.controller = null;
  }

  async tick() {
    if (this.controller) this.controller.abort();
    this.controller = new AbortController();

    try {
      await this.fetchFn(this.controller.signal);
    } catch (err) {
      if (err.name !== 'AbortError') console.error(err);
    }
  }

  start() {
    this.tick();
    this.timer = setInterval(() => this.tick(), this.intervalMs);
  }

  stop() {
    clearInterval(this.timer);
    if (this.controller) this.controller.abort();
  }
}

// Usage
const livePoller = new Poller(async (signal) => {
  const res = await fetch(`${BASE}/fixtures?live=all&key=${API_KEY}`, { signal });
  const data = await res.json();
  updateUI(data.response);
}, 20000);

livePoller.start();

// When leaving the page
window.addEventListener('beforeunload', () => livePoller.stop());

3. Cache local simples / Simple local cache

Para dados que mudam raramente (times, ligas), um cache em memoria com TTL evita chamadas desnecessarias.

const cache = new Map();

async function cachedFetch(url, ttlMs) {
  const cached = cache.get(url);
  if (cached && Date.now() - cached.time < ttlMs) {
    return cached.data;
  }

  const res = await fetch(url);
  const data = await res.json();
  cache.set(url, { data, time: Date.now() });
  return data;
}

// Teams cached for 24h
const teams = await cachedFetch(
  `${BASE}/teams?league=71&season=2025&key=${API_KEY}`,
  86400000
);

4. Dicas gerais / General tips

• So faca polling de jogos ao vivo quando houver jogos acontecendo / Only poll live fixtures when matches are happening
• Use o endpoint /fixtures?date=today para saber se ha jogos no dia / Use to check if there are matches today
• Armazene IDs de ligas e times localmente — eles nao mudam / Store league and team IDs locally — they don't change
• Combine chamadas: busque standings de varias ligas em sequencia com delay, nao em paralelo / Combine calls: fetch standings sequentially with delay, not in parallel
• Monitore o header x-ratelimit-remaining para saber quantas chamadas restam / Monitor to know remaining calls

Back to Football API docs