创建 API 路由

API 路由允许你在 Next.js 应用内部创建一个 API 端点。你可以通过在 pages/api 目录下创建一个具有以下格式的函数来实现：

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

在API 路由文档中了解更多关于上述请求处理器的信息。

它们可以作为无服务器函数（也称为 Lambdas）进行部署。

创建一个简单的 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 路由的技巧。