SuperAPI AI 工具集

route-handlers

编程与开发

查看项目

更新于 10-16 00:20

技能介绍

用途:在 Next.js 应用中创建 API 端点。路由处理器定义在 app 目录下的 route.ts(或 route.js)文件中,使用 Web Request 和 Response API,可用于构建 REST API、添加端点、处理 POST 请求等。

主要能力:按 HTTP 方法名导出函数,支持 GET、POST、PUT、PATCH、DELETE、HEAD、OPTIONS。可读取 JSON、FormData、文本请求体,解析动态路由参数与查询参数、读取请求头。响应方面支持 NextResponse.json、自定义响应头、通过 next/headers 的 cookies 设置 Cookie、重定向(redirect 函数或 NextResponse.redirect)。还支持流式响应(文本流、AI/LLM 流式输出)、CORS 配置(OPTIONS 导出)以及缓存控制(GET 默认静态缓存,可用 dynamic = 'force-dynamic' 或使用 cookies/headers 退出缓存)。错误处理可用 try/catch 返回不同状态码。

使用方式:在 app/api/... 路径下创建 route.ts,导出与方法同名的异步函数;例如 app/api/users/route.ts 对应 /api/users,app/api/posts/[id]/route.ts 对应 /api/posts/:id,动态参数通过 context.params 获取。

适用场景与限制:适合在 Next.js App Router 中实现服务端 API 逻辑、数据库增删改查、鉴权校验、流式 AI 响应等。资料未提供额外限制、收费或平台信息。