Quando sceglieresti GraphQL rispetto a REST, e quando no?

Question

IT Interview Practice · Accepted Answer

Scegli in base a **chi consuma l'API e quanto sono variabili le loro esigenze di dati** — non in base all'hype. GraphQL vince quando molti client eterogenei devono modellare i propri dati; REST vince quando le richieste sono uniformi, cacheabili e semplici.

## Scegli GraphQL quando

- **Molti client con esigenze diverse** — web, iOS, Android vogliono ciascuno campi diversi dalle stesse entità. GraphQL elimina l'over/under-fetching, così non devi rilasciare un nuovo endpoint per ogni schermata.
- **Dati fortemente relazionati/simili a un grafo** — una sola query attraversa le relazioni (`user -> posts -> comments`) invece di N round trip REST.
- **Iterazione rapida del prodotto** — l'evoluzione additiva dello schema permette ai team frontend di aggiungere campi senza aspettare nuovi endpoint o versioni del backend.
- **Aggregazione di microservizi** — un gateway federato presenta un unico grafo su molti servizi (pattern BFF).

## Scegli REST quando

- **Risorse semplici e uniformi** con accesso prevedibile — CRUD in cui ogni client vuole la stessa forma.
- **Il caching HTTP / CDN conta di più** — il modello URL + `GET` di REST viene messo in cache banalmente a ogni livello; GraphQL ha bisogno delle persisted query per avvicinarsi.
- **Upload/download di file, dati binari o API pubbliche** dove vincono ampio tooling, status code e semplicità.
- **Team piccolo / bassa complessità** — il costo lato server di GraphQL (resolver, controllo N+1, limiti di costo delle query, tooling dello schema) non vale la pena per una manciata di endpoint.

## La tabella onesta dei compromessi

| Aspetto | GraphQL | REST |
|---|---|---|
| Over/under-fetching | Risolto per design | Problema comune |
| Caching HTTP/CDN | Difficile (richiede lavoro) | Nativo e facile |
| Controllo costo query/DoS | Devi aggiungerlo tu | Naturalmente limitato |
| Flessibilità del client | Alta | Bassa |
| Complessità del server | Maggiore | Minore |

Inoltre non si escludono a vicenda — molti sistemi espongono REST per gli endpoint pubblici/cacheabili e GraphQL per i client interni ricchi.

## Perché è importante

Gli intervistatori senior stanno testando il **giudizio, non la fedeltà**. La risposta forte nomina gli assi — diversità dei client, esigenze di caching, maturità del team, superficie DoS — e ammette i costi reali di GraphQL (caching e controllo del costo delle query) invece di venderlo come universalmente migliore.

Aspetto	GraphQL	REST
Over/under-fetching	Risolto per design	Problema comune
Caching HTTP/CDN	Difficile (richiede lavoro)	Nativo e facile
Controllo costo query/DoS	Devi aggiungerlo tu	Naturalmente limitato
Flessibilità del client	Alta	Bassa
Complessità del server	Maggiore	Minore

Scegli GraphQL quando

Scegli REST quando

La tabella onesta dei compromessi

Perché è importante

Domande correlate