GraphQL
G
Definition complete
GraphQL est un langage de requete pour APIs developpe par Facebook (2012, open-source 2015), offrant une alternative a REST. Il permet aux clients de demander exactement les donnees necessaires en une seule requete, resolvant les problemes d'over-fetching et under-fetching de REST.
Le principe : un schema type definit les donnees disponibles, le client envoie une requete specifiant exactement les champs souhaites, et le serveur retourne precisement ces donnees. Contrairement a REST ou les endpoints sont fixes, GraphQL offre un point d'entree unique flexible.
Les avantages de GraphQL : pas de sur-chargement de donnees (le client choisit), une seule requete pour des donnees complexes (vs multiples calls REST), typage fort et introspection du schema, et evolution de l'API sans versioning (ajout de champs sans casser les clients).
Les inconvenients : complexite accrue (learning curve, tooling), difficulte de mise en cache (requetes uniques), potentiel de requetes couteuses (clients demandant trop), et performances variables selon l'implementation serveur.
Exemples pratiques
- Requete simple : { user(id: 123) { name, email, posts { title } } } retourne uniquement le nom, email et titres des posts de l'utilisateur.
- Mutation : mutation { createPost(title: "Hello", content: "World") { id } } cree un post et retourne son ID.
- Stack : Apollo Client (frontend) + Apollo Server (backend Node.js) est une combinaison populaire.
A quoi sert GraphQL ?
GraphQL convient aux applications avec donnees complexes et imbriquees, aux clients mobiles (bande passante limitee), aux APIs publiques (flexibilite pour les developpeurs tiers), et aux architectures microservices (federation de schemas).
GraphQL en pratique chez 123web
Chez 123web, nous evaluons GraphQL vs REST selon les besoins de chaque projet. Pour les applications avec des besoins de donnees complexes et variables, GraphQL offre une flexibilite que nous implementons avec les bonnes pratiques de performance et securite.