GraphQL vs REST: Guida alla Scelta del Design API

Cos'è REST API?

REST (Representational State Transfer) è uno stile architetturale API costruito sul protocollo HTTP. Le risorse sono identificate da URIs.

Ogni endpoint rappresenta una risorsa o collezione specifica: GET /users, GET /users/123, POST /users.

Le operazioni CRUD vengono eseguite con i metodi HTTP (GET, POST, PUT, DELETE). Il formato di risposta è solitamente JSON.

REST si basa sui principi stateless, cacheable e uniform interface. Usa tutte le funzionalità HTTP (caching, codici di stato).

Cos'è GraphQL?

GraphQL è un linguaggio di query e un runtime sviluppato da Facebook. Il client interroga esattamente i dati di cui ha bisogno.

Endpoint unico: /graphql. Il client specifica quali campi vuole nella query. Il server restituisce solo i campi richiesti.

Schema: Sistema di tipi dell'API. Il modello di dati è definito con type definitions. Tipi Query, Mutation e Subscription.

Resolver: Funzioni che accedono alla fonte di dati per ogni campo. I dati possono essere recuperati da database, REST API, microservizio, ecc.

Confronto: Vantaggi e Svantaggi

Over-fetching/Under-fetching: REST restituisce dati inutili (over-fetching) o dati insufficienti (under-fetching). GraphQL restituisce esattamente i dati richiesti.

Richiesta singola: Con GraphQL possono essere recuperate più risorse in una singola richiesta. Con REST sono necessarie più richieste.

Caching: REST supporta naturalmente il caching HTTP (Cache-Control, ETag). Il caching in GraphQL è più complesso (persisted queries, Apollo cache).

Curva di apprendimento: REST si impara con la conoscenza HTTP. GraphQL richiede nuovi concetti come schema, resolver, query language.

Tooling: Postman, Swagger per REST. GraphiQL, Apollo Studio per GraphQL. Entrambi hanno buoni ecosistemi di strumenti.

Casi d'Uso

Preferisci REST: API CRUD semplici, API pubbliche, quando il caching è importante, quando la larghezza di banda è limitata per le app mobili.

Preferisci GraphQL: Requisiti di dati complessi, più frontends (web, mobile, desktop), aggregazione di microservizi, sottoscrizioni in tempo reale.

Approccio ibrido: REST per API pubblica, GraphQL per interno/federation. Alcune aziende usano entrambi insieme.

BFF (Backend for Frontend): Strato GraphQL separato per ogni frontend. Query diverse per web e mobile.

Confronto delle Prestazioni

REST: Caching HTTP, supporto CDN, load balancing semplice. Ogni endpoint può essere cacheato indipendentemente.

GraphQL: Problema N+1 (risolto con DataLoader), analisi della complessità delle query, caching con persisted queries.

Larghezza di banda: GraphQL previene il trasferimento di dati inutili. Fornisce risparmi di larghezza di banda per le app mobili.

Latenza: REST può richiedere più round-trip. GraphQL ottiene tutti i dati in una singola richiesta. Tuttavia, query complesse possono essere lente lato server.

Criteri di Selezione

Esperienza del team: REST è più comune e conosciuto. GraphQL richiede più apprendimento.

Consumatori API: REST per API pubblica (maggiore compatibilità). GraphQL per API interna (più flessibilità).

Complessità dei dati: REST per modelli di dati semplici. GraphQL per modelli di dati complessi e correlati.

Requisito di caching: REST per caching intensivo. GraphQL subscriptions per dati in tempo reale.

Migrazione: Avvolgere l'API REST esistente con GraphQL (schema stitching, federation). Fare transizione graduale.