GraphQL vs REST: Scegliere lo Stile API Giusto

GraphQL vs REST: Scegliere lo Stile API Giusto

Sia GraphQL che REST sono architetture API valide. La scelta dipende dal team, requisiti prodotto e vincoli tecnici.

Fondamenti REST

Risorse come sostantivi, verbi HTTP (GET, POST, PUT, PATCH, DELETE). Stateless, cacheable, uniform interface. HATEOAS per discoverability. Versioning in URL (/v1/). Tooling ampio, caching browser-native, CDN-friendly. Over-fetching/under-fetching comuni.

Fondamenti GraphQL

Singolo endpoint, query client-driven. Schema: Fortemente tipizzato (SDL). Query (lettura), Mutation (scrittura), Subscription (real-time). Resolver recuperano dati. Niente over/under-fetching. Introspezione per tooling. Federation per microservizi.

Flessibilità vs Struttura

GraphQL: Massima flessibilità, client chiedono esattamente ciò che serve. REST: Strutturato, prevedibile, server definisce risposte. GraphQL meglio per: Client multipli (web, mobile, TV), UI in rapida evoluzione, relazioni complesse. REST meglio per: Risorse semplici, API pubbliche, caching critico, familiarità team.

Performance

GraphQL: Singola richiesta, ma problema N+1 (risolto con DataLoader). Analisi costo complessità necessaria. REST: Richieste multiple, ma HTTP/2 multiplexing aiuta. Caching: REST nativo (HTTP), GraphQL richiede cache normalizzata (Apollo, Relay) o persisted queries + CDN.

Caching

Caching

REST: HTTP caching (ETag, Cache-Control, CDN) funziona out of the box. GraphQL: Singolo endpoint (POST), niente caching HTTP nativo. Soluzioni: Persisted queries (GET per query), cache normalizzata client (Apollo, Relay), CDN con APQ. Direttive Cache-Control in schema (@cacheControl).

Curva Apprendimento e Tooling

REST: Barriera bassa, familiare a tutti. GraphQL: Più ripida (schema, resolver, DataLoader, federation). Tooling: GraphQL ha DX eccellente (GraphiQL, Voyager, Codegen, Apollo Studio). REST: OpenAPI/Swagger, Postman, Insomnia. Entrambi hanno ecosistemi forti.

Sicurezza

GraphQL: Limitazione profondità, analisi costo, rate limiting, disabilita introspezione, persisted queries (allowlist). REST: Auth standard, rate limiting, input validation. Entrambi necessitano: AuthN/AuthZ, validazione, monitoraggio.

Migrazione e Coesistenza

Strangler Fig: Sostituisci gradualmente REST con GraphQL. GraphQL gateway su servizi REST. REST wrapper su GraphQL. Ibrido: REST per semplice, GraphQL per complesso. Non riscrivere tutto insieme.

Matrice Decisionale

Scegli GraphQL se: Client multipli con bisogni dati diversi, relazioni complesse, iterazione rapida, federation necessaria, subscription real-time. Scegli REST se: CRUD semplice, API pubblica, caching fondamentale, team non familiare con GraphQL, compliance regolamentare (audit più semplice), microservizi con confini chiari.