Cos'è GraphQL?

GraphQL è un linguaggio di query e un runtime per API che permette ai client di richiedere esattamente i dati di cui hanno bisogno in un'unica chiamata. Invece di più endpoint REST con forme di risposta fisse, un server GraphQL espone uno schema tipizzato, e i client inviano query che attraversano lo schema per recuperare solo i campi rilevanti.

Definizione

Uno schema GraphQL descrive tipi, relazioni e operazioni: query per leggere i dati, mutation per modificarli e subscription per gli aggiornamenti in tempo reale. I client inviano query verso un unico endpoint, e il server risolve ciascun campo richiamando le fonti di dati sottostanti. Il contratto fortemente tipizzato consente tooling, generazione di codice e percorsi di deprecazione chiari.

Perché è importante

Per i frontend commerce, GraphQL riduce l'over-fetching e l'under-fetching che affliggono le integrazioni REST tra servizi eterogenei. Una pagina di dettaglio prodotto può richiedere prodotto, prezzo, inventario, recensioni e articoli correlati in un'unica query, modellata esattamente per l'albero dei componenti. Combinato con le persisted query, questo migliora anche la cacheability e riduce l'overhead di rete.

Considerazioni

GraphQL introduce complessità sul lato server, tra cui il design dei resolver, il tuning delle performance e la protezione contro query costose. È più utile in ambienti dove più frontend condividono lo stesso backend e dove la flessibilità a livello di campo è importante. Nelle architetture composable, GraphQL vive spesso nel livello BFF o nella storefront API, davanti ai servizi REST dei singoli microservizi.

Correlati

Scopri Composable Headless Frontend · Composable Digital Experience Platform.