WebSocket vs REST vs GraphQL: Quale Scegliere nel 2025

Introduzione alla Comunicazione Real-Time

Le applicazioni moderne spesso necessitano di aggiornamenti in tempo reale—messaggi chat, notifiche live, editing collaborativo. Questa guida confronta WebSocket, REST e GraphQL per aiutarti a scegliere la tecnologia giusta.

REST: Il Classico

Come Funziona

REST usa richieste HTTP stateless per operazioni CRUD:

GET    /api/users      # Lista utenti
GET    /api/users/123  # Singolo utente
POST   /api/users      # Crea utente
PUT    /api/users/123  # Aggiorna utente
DELETE /api/users/123  # Elimina utente

Vantaggi

• Semplice da capire e implementare
• Stateless = facile da scalare
• Caching HTTP nativo
• Ampio supporto e tooling

Svantaggi

• Over-fetching: ricevi dati che non ti servono
• Under-fetching: servono multiple richieste
• Nessun supporto real-time nativo
• Polling inefficiente per aggiornamenti frequenti

GraphQL: Query Flessibili

Come Funziona

GraphQL usa un singolo endpoint con query flessibili:

# Richiedi solo i campi necessari
query {
  user(id: 123) {
    name
    email
    posts {
      title
      createdAt
    }
  }
}

# Mutation per modifiche
mutation {
  createUser(name: "Mario", email: "mario@email.it") {
    id
    name
  }
}

Vantaggi

• Richiedi esattamente i dati necessari
• Singola richiesta per dati correlati
• Schema tipizzato e auto-documentante
• Subscriptions per real-time

Svantaggi

• Curva di apprendimento più ripida
• Caching più complesso
• Query complesse possono sovraccaricare il server
• Overhead per richieste semplici

WebSocket: Real-Time Bidirezionale

Come Funziona

WebSocket mantiene una connessione persistente per comunicazione bidirezionale:

// Client
const ws = new WebSocket("wss://api.example.com/ws");

ws.onopen = () => {
  ws.send(JSON.stringify({ type: "subscribe", channel: "chat" }));
};

ws.onmessage = (event) => {
  const data = JSON.parse(event.data);
  console.log("Messaggio ricevuto:", data);
};

// Server può inviare messaggi in qualsiasi momento
ws.send(JSON.stringify({ type: "message", text: "Ciao!" }));

Vantaggi

• Latenza minima per real-time
• Comunicazione bidirezionale
• Efficiente per messaggi frequenti
• Connessione persistente = meno overhead

Svantaggi

• Più complesso da scalare (connessioni stateful)
• Gestione riconnessioni necessaria
• Nessun caching HTTP
• Load balancing più complesso

Quando Usare Cosa

Usa REST quando:

• API pubblica con molti consumer diversi
• Operazioni CRUD semplici
• Caching importante
• Team con esperienza REST

Usa GraphQL quando:

• Frontend ha bisogno di flessibilità nei dati
• Multiple piattaforme (web, mobile) con esigenze diverse
• Dati fortemente correlati
• Vuoi ridurre il numero di richieste

Usa WebSocket quando:

• Chat e messaggistica
• Gaming multiplayer
• Trading e dati finanziari
• Collaborazione real-time (Google Docs style)
• Notifiche push immediate

Combinare le Tecnologie

Spesso la soluzione migliore è combinare:

// REST per CRUD standard
GET /api/products

// WebSocket per aggiornamenti real-time
ws.onmessage → aggiorna lista prezzi

// GraphQL per query complesse dashboard
query { analytics { ... } }

Performance a Confronto

Metrica	REST	GraphQL	WebSocket
Latenza	Media	Media	Bassa
Bandwidth	Alto (over-fetch)	Ottimale	Basso
Scalabilità	Facile	Media	Complessa
Caching	Semplice	Complesso	Manuale

Conclusione

Non esiste una soluzione universale. REST rimane eccellente per API standard, GraphQL brilla per frontend complessi, WebSocket è imbattibile per real-time. Valuta le esigenze del tuo progetto e non aver paura di combinare tecnologie diverse.