Cos'è GraphQL?

GraphQL è un linguaggio di query per API e un ambiente di esecuzione per eseguire queste query. Permette al client di richiedere esattamente i dati di cui ha bisogno, definendo la struttura della risposta. A differenza delle API REST tradizionali, dove si richiedono endpoint, GraphQL invia una richiesta a un singolo endpoint, specificando i campi richiesti.

Concetti principali di GraphQL:

• Schema: Definisce i tipi di dati, le operazioni disponibili (query, mutazioni, sottoscrizioni) e le relazioni tra i tipi. Si scrive in Schema Definition Language (SDL).
• Tipi: Definiscono la struttura dei dati. Possono essere scalari (String, Int, Float, Boolean, ID), personalizzati o tipi contenitore (Liste, Non-Null).
• Query: Usate per ottenere dati dal server. Il client indica quali campi sono necessari e il server restituisce solo quei campi.
• Mutazioni: Usate per modificare i dati sul server (creazione, aggiornamento, eliminazione). Sono simili alle query, ma indicano chiaramente un cambiamento di stato.
• Sottoscrizioni: Permettono al client di ricevere aggiornamenti in tempo reale man mano che i dati cambiano sul server.

Vantaggi di GraphQL:

• Efficienza: Il client richiede solo i dati necessari, riducendo la quantità di dati trasmessi e prevenendo l'overfetching.
• Flessibilità: Il client definisce la struttura della risposta, semplificando lo sviluppo e l'evoluzione dell'API.
• Miglioramento delle prestazioni: L'ottenimento efficiente dei dati può accelerare il caricamento delle pagine.
• Tipizzazione rigorosa: Lo schema fornisce un contratto chiaramente definito tra client e server, facilitando la validazione e la rilevazione degli errori.

Esempio di query:

query GetUser {
  user(id: "123") {
    name
    email
    posts {
      title
    }
  }
}

Esempio di mutazione:

mutation CreatePost {
  createPost(input: { title: "Nuovo Post", content: "..." }) {
    id
    title
  }
}