Création de routes API

Les routes API vous permettent de créer un point de terminaison API dans une application Next.js. Pour ce faire, créez une fonction dans le répertoire pages/api avec le format suivant :

// req = message HTTP entrant, res = réponse du serveur HTTP
export default function handler(req, res) {
  // ...
}

Apprenez-en plus sur le gestionnaire de requêtes ci-dessus dans la documentation des routes API.

Elles peuvent être déployées en tant que fonctions serverless (également appelées Lambdas).

Création d'un point de terminaison API simple

Essayons cela. Créez un fichier appelé hello.js dans pages/api avec le code suivant :

export default function handler(req, res) {
  res.status(200).json({ text: 'Hello' });
}

Essayez d'y accéder à l'adresse http://localhost:3000/api/hello. Vous devriez voir {"text":"Hello"}. Notez que :

• req est une instance de http.IncomingMessage, avec en plus des middlewares préconstruits.
• res est une instance de http.ServerResponse, avec en plus des fonctions d'aide.

C'est tout ! Avant de conclure cette leçon, parlons de quelques conseils pour utiliser les routes API dans la page suivante.