API 路由

基于文件的 API 路由,支持 HTTP 方法和动态参数。
api/hello.ts
import { defineHandler } from "nitro/h3";

export default defineHandler(() => "Nitro is amazing!");

Nitro 支持在 api/routes/ 目录中的基于文件的路由。每个文件根据其路径变成一个 API 端点。

基本路由

api/ 目录中创建一个文件来定义路由。文件路径即为 URL 路径:

api/hello.ts
import { defineHandler } from "nitro/h3";

export default defineHandler(() => "Nitro is amazing!");

这将创建一个 GET /api/hello 端点。

动态路由

使用方括号 [param] 表示动态 URL 段。通过 event.context.params 访问参数:

api/hello/[name].ts
import { defineHandler } from "nitro/h3";

export default defineHandler((event) => `Hello (param: ${event.context.params!.name})!`);

这将创建一个 GET /api/hello/:name 端点(例如 /api/hello/world)。

HTTP 方法

通过文件后缀指定 HTTP 方法(.get.ts.post.ts.put.ts.delete.ts 等):

GET 处理器

api/test.get.ts
import { defineHandler } from "nitro/h3";

export default defineHandler(() => "Test get handler");

POST 处理器

api/test.post.ts
import { defineHandler } from "h3";

export default defineHandler(async (event) => {
  const body = await event.req.json();
  return {
    message: "Test post handler",
    body,
  };
});

了解更多