Erstellen von API-Routen

API-Routen ermöglichen es Ihnen, einen API-Endpunkt innerhalb einer Next.js-Anwendung zu erstellen. Dies können Sie erreichen, indem Sie eine Funktion im Verzeichnis pages/api erstellen, die folgendes Format hat:

// req = HTTP eingehende Nachricht, res = HTTP Server-Antwort
export default function handler(req, res) {
  // ...
}

Erfahren Sie mehr über den oben gezeigten Request-Handler in der API-Routen Dokumentation.

Diese können als Serverless Functions (auch bekannt als Lambdas) bereitgestellt werden.

Erstellen eines einfachen API-Endpunkts

Probieren wir es aus. Erstellen Sie eine Datei namens hello.js in pages/api mit folgendem Code:

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

Versuchen Sie, darauf unter http://localhost:3000/api/hello zuzugreifen. Sie sollten {"text":"Hallo"} sehen. Beachten Sie:

• req ist eine Instanz von http.IncomingMessage, plus einige vordefinierte Middlewares.
• res ist eine Instanz von http.ServerResponse, plus einige Hilfsfunktionen.

Das war's! Bevor wir diese Lektion abschließen, lassen Sie uns auf der nächsten Seite über einige Tipps zur Verwendung von API-Routen sprechen.