概述
Next.js 是一个 React 应用程序框架，它提供了一组工具和约定，使得构建 React 应用程序变得更加容易。其中一个非常有用的功能是 Next.js API 路由，它可以帮助我们快速构建 RESTful API 服务。本文将介绍 Next.js API 路由的基础知识和使用方法。
API 路由基础
API 路由是一种特殊的路由，它用于处理 HTTP 请求，并返回 JSON 响应。在 Next.js 中，我们可以通过在 pages/api 目录下创建文件来定义 API 路由。例如，我们可以在 pages/api/hello.js 文件中创建一个简单的 API 路由：
export default (req, res) => {
res.status(200).json({ message: 'Hello World!' })
}在上面的代码中，我们导出了一个函数，它接收两个参数 req 和 res，分别代表 HTTP 请求和响应。我们在函数中调用 res.status(200).json({ message: 'Hello World!' }) 来返回一个状态码为 200 的 JSON 响应。
我们可以通过访问 http://localhost:3000/api/hello 来触发这个 API 路由，并得到一个 JSON 响应：
{ "message": "Hello World!" }API 路由的参数
API 路由可以接收参数，这使得我们可以根据不同的参数返回不同的响应。在 Next.js 中，我们可以通过在文件名中使用中括号来定义 API 路由参数。例如，我们可以在 pages/api/posts/[id].js 文件中创建一个 API 路由，它接收一个 id 参数：
export default (req, res) => {
const { id } = req.query
res.status(200).json({ id })
}在上面的代码中，我们使用 req.query 来获取 URL 查询参数，并将其包含在 JSON 响应中。我们可以通过访问 http://localhost:3000/api/posts/123 来触发这个 API 路由，并得到一个 JSON 响应：
{ "id": "123" }API 路由的方法
API 路由可以处理不同的 HTTP 方法，例如 GET、POST、PUT、DELETE 等。在 Next.js 中，我们可以通过导出不同的函数来处理不同的 HTTP 方法。例如，我们可以在 pages/api/posts.js 文件中创建一个 API 路由，它处理 GET 和 POST 方法：
-- -------------------- ---- -------
------ ------- ----- ---- -- -
-- ----------- --- ------ -
---------------------- -------- ---- ------ --
- ---- -- ----------- --- ------- -
---------------------- -------- ------- ----- --
- ---- -
---------------------
-
-在上面的代码中，我们使用 req.method 来获取 HTTP 方法，并根据不同的方法返回不同的响应。如果请求的方法不是 GET 或 POST，我们返回状态码为 405 的响应。
API 路由的中间件
API 路由也支持使用中间件，这使得我们可以在请求到达 API 路由之前或之后执行一些操作。在 Next.js 中，我们可以使用 micro 模块来实现中间件。例如，我们可以在 pages/api/posts.js 文件中创建一个 API 路由，它使用中间件验证请求头中是否包含 Authorization 字段：
-- -------------------- ---- -------
------ ----- ---- -------
----- -------------- - ------- -- ----- ---- -- -
-- ---------------------------- -
------ --------------- ---- ---------------
-
------ ------------ ----
-
----- ------- - ----- ---- -- -
-- ----------- --- ------ -
---------------------- -------- ---- ------ --
- ---- -- ----------- --- ------- -
---------------------- -------- ------- ----- --
- ---- -
---------------------
-
-
------ ------- -----------------------在上面的代码中，我们定义了一个 authMiddleware 中间件，它接收一个处理函数 handler，并返回一个新的处理函数。在中间件中，我们检查请求头中是否包含 Authorization 字段，如果没有则返回状态码为 401 的响应。如果有，则调用 handler 处理函数来处理请求。
总结
本文介绍了 Next.js API 路由的基础知识和使用方法。我们学习了如何创建简单的 API 路由、如何接收参数、如何处理不同的 HTTP 方法以及如何使用中间件。API 路由是构建 RESTful API 服务的重要工具，它可以帮助我们快速构建高效、可靠的 API 服务。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/65e3ee551886fbafa402ae33