Next.js: Route handlers (API) — ментальная модель

route.ts — API через Web Request/Response (не Node req/res): export GET, POST… → served at segment path. Замена pages/api в App Router.

Разбор

Segment serves UI or API, never both — page.tsx vs route.ts. Handlers — Web Platform: Request in, Response out, как Service Worker или Edge. Deliberate move от Pages (req, res):

// app/api/users/route.ts  →  serves /api/users
export async function GET(request: Request) {
  return Response.json({ users: [] });
}
export async function POST(request: Request) {
  const body = await request.json();
  return Response.json({ created: body }, { status: 201 });
}

One HTTP method = one exported function. Unhandled methods → 405 Method Not Allowed automatically.

Итог

Route handlers — Web-standard API segments; переносимость Edge/Node и единый mental model с fetch API.