用途：为 Next.js 15 App Router 项目提供 API 路由的编写模式，适用于在 app/api/**/*.ts 下新建接口、处理请求、配置超时、做认证与校验、构建服务端端点等场景。
主要能力：给出 GET、POST、PUT、DELETE 的标准写法，使用 NextRequest 与 NextResponse；支持动态路由参数（如 app/api/campaigns/[id]/route.ts 中通过 params.id 取值）；提供请求体解析与必填字段校验、统一错误处理与 ValidationError 模式、成功/错误/分页响应格式、自定义响应头与 CORS（OPTIONS）配置；包含基于 Supabase 的 Cookie 会话认证与 CRON_SECRET 的 Bearer 校验；支持批量处理与 ReadableStream 流式响应。
超时与运行时：通过 export const maxDuration 配置，默认 10 秒；资料列出 Pro 计划 serverless 最长 300 秒、Edge Runtime 最长 900 秒、workflow 步骤 800 秒，并给出 10/60/300/600/800 秒的示例。可用 export const runtime = 'edge' 或 'nodejs'，以及 export const dynamic = 'force-dynamic' 关闭静态优化。
使用方式：在路由文件中导出对应 HTTP 方法函数，解析 request.json() 或 request.nextUrl.searchParams，校验后执行业务逻辑并返回 NextResponse.json；按需导出 maxDuration、runtime、dynamic。
限制与注意：资料强调必须校验输入、按操作时长设置 maxDuration、按 newsletter_id 做租户数据过滤、统一响应格式并记录错误；不要向客户端暴露敏感错误细节或原始数据库错误。Edge Runtime 仅支持有限的 Node.js API。具体部署平台、版本兼容与计费细节暂未提供。