Comment configurer une API GraphQL avec Node.js

• Sommaire

  • Comment configurer une API GraphQL avec Node.js
  • Prérequis
  • Installation des dépendances
  • Création du serveur
  • Tester l’API
  • Conclusion

Comment configurer une API GraphQL avec Node.js

GraphQL est une technologie de requête d’API qui permet aux clients de demander exactement les données dont ils ont besoin, et rien de plus. Contrairement à REST, où les endpoints sont fixes, GraphQL offre une flexibilité inégalée. Dans cet article, nous allons explorer comment configurer une API GraphQL en utilisant Node.js, un environnement d’exécution JavaScript populaire.

Prérequis

Avant de commencer, assurez-vous d’avoir installé Node.js sur votre machine. Vous pouvez le télécharger depuis le site officiel de Node.js. De plus, il est recommandé d’avoir une connaissance de base de JavaScript et de la gestion des packages avec npm.

Installation des dépendances

Pour créer une API GraphQL, nous allons utiliser quelques bibliothèques essentielles.

. Ouvrez votre terminal et créez un nouveau dossier pour votre projet :

mkdir graphql-api
cd graphql-api
npm init -y

Ensuite, installez les dépendances nécessaires :

npm install express express-graphql graphql

Ces bibliothèques incluent Express pour le serveur web, express-graphql pour intégrer GraphQL à Express, et graphql pour définir notre schéma.

Création du serveur

Maintenant, créons un fichier nommé server.js et ajoutons le code suivant :

const express = require('express');
const { graphqlHTTP } = require('express-graphql');
const { buildSchema } = require('graphql');

const app = express();

// Définir le schéma GraphQL
const schema = buildSchema(`
  type Query {
    hello: String
  }
`);

// Résolveurs
const root = {
  hello: () => 'Bonjour, monde!',
};

// Configurer le middleware GraphQL
app.use('/graphql', graphqlHTTP({
  schema: schema,
  rootValue: root,
  graphiql: true,
}));

app.listen(4000, () => console.log('Serveur GraphQL en cours d'exécution sur http://localhost:4000/graphql'));

Ce code crée un serveur Express qui écoute sur le port 4000 et expose un endpoint GraphQL à l’adresse /graphql. Le schéma définit une seule requête hello qui renvoie une chaîne de caractères.

Tester l’API

Pour tester votre API, ouvrez votre navigateur et accédez à http://localhost:4000/graphql. Vous verrez l’interface GraphiQL, qui vous permet d’exécuter des requêtes. Essayez la requête suivante :

{ hello }

Vous devriez recevoir la réponse suivante :

{
  "data": {
    "hello": "Bonjour, monde!"
  }
}

Conclusion

Vous avez maintenant configuré une API GraphQL simple avec Node.js. Cette approche vous permet de développer des applications plus flexibles et efficaces. En ajoutant des types, des mutations et des abonnements, vous pouvez étendre cette API pour répondre à des besoins plus complexes. N’hésitez pas à explorer davantage les fonctionnalités de GraphQL et à les intégrer dans vos projets futurs !