概要

Next.jsでAPIを構築する方法を学びます。Next.jsはサーバーサイドで動作するAPIエンドポイントを簡単に作成でき、アプリケーションのフロントエンドと同一リポジトリでAPIを管理できます。

主な方法

• Pages Router（pages/api）
  • 従来の方法。pages/api/*.js にエンドポイントを作成すると、自動的にAPIルートになります。
• App Router（Route Handlers）
  • app ディレクトリを使う場合、app/api/.../route.js のようにハンドラを定義します。HTTPメソッドごとに GET/POST 等の関数をエクスポートします。
• Edge Runtime と Node.js Runtime
  • runtime = 'edge' を使うと低レイテンシのEdge環境で動作しますが、Nodeの組み込みモジュールが使えないなどの制約があります。

サンプル

• Pages Router の例（pages/api/hello.js）:

  export default function handler(req, res) { res.status(200).json({ message: 'Hello from Next.js API' }) }

• App Router の例（app/api/hello/route.js）:

  export function GET(request) { return new Response(JSON.stringify({ message: 'Hello from Next.js API' }), { status: 200, headers: { 'Content-Type': 'application/json' } }) }

注意点とベストプラクティス

• 入力バリデーションとエラーハンドリングを行う。
• 長時間実行する処理は背景ジョブやサーバーレス関数で切り離す。
• Edge Runtime を使う場合、サポートされていないAPI（例: 一部のNode標準モジュール）に注意する。
• 認証/認可はCookieやヘッダー、トークンを使って適切に実装する。

デプロイと運用

• Vercel などのホスティングにそのままデプロイ可能。ローカルでの開発は npm run dev（または next dev）を使用。
• ログ、モニタリング、レート制限を導入して運用性を高める。

まとめ

Next.jsを使えば、フロントエンドと同じフレームワーク内でAPIを素早く構築できます。用途に応じて pages/api と app の Route Handlers を使い分け、ランタイムの制約を理解した上で設計してください。