Créer une API Rest minimale en NodeJS avec Fastify

Avant de se lancer dans la création de notre première API avec Fastify, il faudra bien vérifier que vous utilisez une version de NodeJS équivalente ou supérieure à 20.0.0 !

Vous pouvez vérifiez la version actuelle avec node —version

Configuration du projet

Si tout est en ordre, nous pouvons commencer à initialiser notre projet. Commencez par créer un dossier my-first-api , et à l’intérieur de ce dossier, exécutez les commande suivantes :

$> npm init
$> npm install fastify

Puis ouvrez le fichier package.json , et ajoutez la ligne suivante :

"type": "module"

Cela n’a rien à voir avec Fastify spécifiquement

Mais déclarer notre projet en tant que module va faire en sorte d’activer import , qui est un équivalent plus moderne de require.

Par exemple, on écrira :

import Fastify from 'fastify';

// au lieu de

const Fastify = require('fastify');

Une API minimale

Créez un fichier app.js dans votre dossier de projet, et copiez-collez le code suivant à l’intérieur :

// On importe le framework
import Fastify from 'fastify'

// On l'initialise avec des options
const fastify = Fastify({
  logger: true
})

// On déclare notre première route
fastify.get('/', async function handler (request, reply) {
  return { hello: 'world' }
});

// Et on lance le serveur !
try {
  await fastify.listen({ port: 3000 })
} catch (err) {
  fastify.log.error(err)
  process.exit(1)
}

Essayez de lancer votre api avec node index.js et vous devriez voir ça dans votre console :

Server listening at http://[::1]:3000

Essayez d’accéder à la première route de votre API en suivant ce lien : http://localhost:3000

Si votre navigateur vous répond {"hello":"world"} alors c’est que votre API est en cours d’exécution et fonctionnelle !