GraphQL vs. REST: Un Nuovo Modo di Pensare le API

Le API sono il cuore della comunicazione tra frontend e backend. Per anni, l'architettura REST è stata lo standard indiscusso. Tuttavia, un nuovo approccio sviluppato da Facebook, chiamato GraphQL, sta guadagnando sempre più popolarità per la sua flessibilità.

L'Approccio REST

REST (Representational State Transfer) è un'architettura basata su risorse (es. `/users`, `/products`). Ogni risorsa ha un suo endpoint (URL). Per ottenere informazioni, il client fa una richiesta HTTP a uno di questi endpoint.

Il problema: REST può portare a due problemi opposti:

• Over-fetching: L'endpoint restituisce più dati di quelli che servono al client. Ad esempio, se chiedo i dati di un utente per mostrare solo il suo nome, l'API REST potrebbe restituirmi anche indirizzo, email, data di nascita, etc., sprecando banda.
• Under-fetching: L'endpoint non restituisce abbastanza dati, costringendo il client a fare più chiamate. Ad esempio, per mostrare un post del blog e i commenti, potrei dover fare una chiamata a `/posts/1` e poi un'altra a `/posts/1/comments`.

L'Approccio GraphQL

GraphQL non ha endpoint multipli, ma un unico endpoint. È il client a descrivere esattamente i dati di cui ha bisogno in una singola richiesta (chiamata query). Il server risponderà con un JSON che rispecchia esattamente la struttura della richiesta.

Esempio di query GraphQL:

{
  post(id: "1") {
    title
    author {
      name
    }
  }
}

Con questa singola richiesta, il client ottiene esattamente il titolo del post e il nome del suo autore, né più, né meno. Questo risolve sia il problema dell'over-fetching che dell'under-fetching.

Quando Usare GraphQL?

GraphQL brilla in applicazioni complesse dove il frontend ha esigenze di dati molto variabili, come nelle app mobile (dove la banda è preziosa) o in sistemi con molti client diversi (web, app, IoT) che hanno bisogno di dati differenti.

REST rimane un'ottima scelta, più semplice da implementare, per API più tradizionali e con esigenze di dati ben definite.