Qu'est-ce que GraphQL?

GraphQL est un langage de requête pour les API et un environnement d'exécution pour exécuter ces requêtes sur vos données. Il offre une alternative à REST, permettant au client de demander uniquement les données dont il a besoin, en une seule requête.

Concepts clés:

Schéma: Définit les types de données disponibles dans l'API, leurs relations et les opérations disponibles (requêtes, mutations, abonnements).
Requêtes (Queries): Utilisées pour lire des données. Le client indique quels champs il souhaite.
Mutations: Utilisées pour modifier des données (création, mise à jour, suppression).
Abonnements (Subscriptions): Utilisés pour recevoir des données en temps réel via une connexion persistante (par exemple, WebSocket).

Exemple de requête:

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

La réponse à cette requête pourrait ressembler à ceci:

{
  "data": {
    "user": {
      "name": "Ivan",
      "email": "ivan@example.com",
      "posts": [
        { "title": "Mon premier article" },
        { "title": "Sur GraphQL" }
      ]
    }
  }
}

Avantages par rapport à REST:

Éviter la sur-sollicitation des données (Over-fetching): Le client ne reçoit que les champs demandés.
Éviter la sous-sollicitation (Under-fetching) / Multiples requêtes: Permet souvent d'obtenir toutes les informations nécessaires en une seule requête, contrairement à REST où plusieurs requêtes à différents endpoints peuvent être nécessaires.
Typage fort: Le schéma fournit une documentation claire et une validation des requêtes.
Meilleure performance: Moins de données transférées.
Flexibilité côté client: Les clients peuvent évoluer indépendamment du serveur, en demandant des données selon leurs besoins.

Inconvénients:

Complexité de configuration côté serveur.
Problèmes de mise en cache comparés aux méthodes standard de cache REST (par exemple, au niveau HTTP).
Plus difficile de gérer les erreurs comparé à REST (qui utilise des codes d'état HTTP standard).