← Integrazioni senza drammiIntegrazioni senza drammi · #1

Una chiamata all'API a ogni visita: serve davvero?

Un pattern molto comune che rallenta i siti e sovraccarica i server, e come una cache sulla CDN lo risolve senza scalare l'infrastruttura.

È un pattern molto comune: uno script JavaScript che, al caricamento della pagina, esegue un fetch per ottenere i dati di cui l'utente ha bisogno.

Con poco traffico funziona perfettamente. Ma quando le visite crescono, ogni utente è una richiesta in più verso il server. E arriva il sintomo classico: tutto diventa più lento.

La domanda chiave

Prima di scalare il server, chiediti: questi dati cambiano a ogni visita o solo ogni tanto?

Se cambiano, ad esempio, una volta al giorno, stai chiedendo al server migliaia di volte la stessa risposta. Ognuna di queste richieste costa tempo all'utente e risorse al server.

La soluzione: una cache sulla CDN

Una CDN ha nodi in tutto il mondo. Se le permetti di conservare una copia della risposta, il flusso cambia completamente:

  • La prima richiesta arriva al server.
  • Le successive ricevono una copia dal nodo più vicino all'utente.
  • Quando il dato cambia, la copia viene rinnovata.

Di solito bastano le intestazioni giuste nella risposta dell'API:

Cache-Control: public, max-age=60, s-maxage=86400, stale-while-revalidate=3600
  • max-age=60: il browser riutilizza la risposta per un minuto.
  • s-maxage=86400: la CDN la conserva fino a 24 ore.
  • stale-while-revalidate=3600: se la copia è scaduta, la CDN continua a servirla mentre ne richiede una nuova in background. L'utente non aspetta mai.

La parte difficile: decidere quando rinnovare

Mettere in cache è facile. Ciò a cui bisogna davvero pensare è quando la copia smette di essere valida e cosa succede se qualcuno vede una versione di qualche ora fa. Ci sono tre strategie comuni:

  • Scadenza (TTL): la copia scade da sola dopo un certo tempo. Ideale quando il dato cambia con un ritmo noto, ad esempio una volta al giorno.
  • Purge all'aggiornamento: quando il dato cambia, si chiama l'API della CDN per eliminare la copia. Sempre aggiornato, ma va integrato nel processo che aggiorna i dati.
  • URL versionate: aggiungere una versione o una data all'URL (/dati?v=2026-11-21). Ogni versione è una copia distinta e non si mescolano mai.
Attenzione: se la risposta dipende dall'utente (sessione, permessi, dati personali), non può finire in una cache condivisa. Quei dati vanno marcati come private o separati dalla parte comune.

Checklist prima di scalare il server

  • Quante richieste ricevono esattamente la stessa risposta?
  • Ogni quanto cambia davvero quel dato?
  • È accettabile che qualcuno veda una versione di qualche minuto o ora fa?
  • La risposta contiene qualcosa di personale o dipende dalla sessione?
  • Come verrà rinnovata la copia quando il dato cambia?

Spesso il miglioramento di performance più economico non è un server più grande, ma smettere di chiedere ciò che sai già.

Questo articolo fa parte di Integrazioni senza drammi: un nuovo pattern ogni settimana.