REST API vs GraphQL: Quale Scegliere nel 2024?

Il Dilemma della Scelta

REST e GraphQL sono entrambe valide opzioni per costruire API. Ma quale dovresti usare? Dipende dalle tue esigenze.

REST API: Il Veterano

REST è stato lo standard de facto per le API negli ultimi 15 anni.

Vantaggi di REST

• Semplicità: Facile da comprendere e implementare
• Caching: HTTP caching nativo
• Tooling maturo: Ampio supporto e documentazione
• Stateless: Ogni richiesta è indipendente

<?php
// Esempio REST API in Laravel
Route::get('/api/users', [UserController::class, 'index']);
Route::get('/api/users/{id}', [UserController::class, 'show']);
Route::post('/api/users', [UserController::class, 'store']);
Route::put('/api/users/{id}', [UserController::class, 'update']);
Route::delete('/api/users/{id}', [UserController::class, 'destroy']);

// Controller
class UserController extends Controller
{
    public function index()
    {
        return User::with('posts', 'comments')->get();
    }

    public function show($id)
    {
        return User::with('posts', 'comments')->findOrFail($id);
    }
}
?>

Svantaggi di REST

GraphQL: Il Nuovo Arrivato

GraphQL permette al client di richiedere esattamente i dati che necessita.

Vantaggi di GraphQL

• Precisione: Richiedi solo i campi necessari
• Single endpoint: Una sola URL per tutte le query
• Type system: Schema fortemente tipizzato
• Introspection: L'API è auto-documentata

<?php
// Esempio GraphQL con Lighthouse (Laravel)
// schema.graphql
type Query {
    users: [User!]! @all
    user(id: ID! @eq): User @find
}

type User {
    id: ID!
    name: String!
    email: String!
    posts: [Post!]! @hasMany
}

type Post {
    id: ID!
    title: String!
    content: String!
    author: User! @belongsTo
}

type Mutation {
    createUser(
        name: String!
        email: String!
    ): User @create
}
?>

// Query dal client
query {
  user(id: 1) {
    name
    email
    posts {
      title
    }
  }
}

// Risposta - solo i dati richiesti
{
  "data": {
    "user": {
      "name": "Giovanni",
      "email": "giovanni@devgd.it",
      "posts": [
        { "title": "Post 1" },
        { "title": "Post 2" }
      ]
    }
  }
}

Svantaggi di GraphQL

Quando Usare REST

Quando Usare GraphQL

La Soluzione Ibrida

Non devi scegliere per forza uno solo! Puoi usare entrambi:

<?php
// REST per operazioni semplici
Route::post('/api/login', [AuthController::class, 'login']);
Route::post('/api/upload', [FileController::class, 'upload']);

// GraphQL per query complesse
Route::post('/graphql', [GraphQLController::class, 'handle']);
?>