API Routesの作成

API Routesを使用すると、Next.jsアプリ内にAPIエンドポイントを作成できます。これは、pages/api ディレクトリ内に以下の形式の関数を作成することで実現できます。

// req = HTTP incoming message, res = HTTP server response
export default function handler(req, res) {
  // ...
}

上記のrequest handlerについて、API Routesドキュメントでさらに詳しく学んでください。

これらはServerless Functions（Lambdaとも呼ばれます）としてデプロイできます。

簡単なAPIエンドポイントの作成

試してみましょう。pages/api に hello.js という名前のファイルを作成し、以下のコードを記述してください。

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

https://:3000/api/hello にアクセスしてみてください。{"text":"Hello"} が表示されるはずです。なお、

• req は http.IncomingMessage のインスタンスであり、いくつかの事前構築された ミドルウェア が追加されています。
• res は http.ServerResponse のインスタンスであり、いくつかの ヘルパー関数 が追加されています。

これで完了です！このレッスンを終える前に、次のページで API Routes を使用する際のヒントについて説明します。