Route Handlers și Proxy

Ce este un Route Handler

Un Route Handler e un endpoint HTTP scris în app/: un fișier route.ts care exportă funcții cu numele metodelor HTTP. Primește un Request standard și returnează un Response standard — exact API-urile Web din lecția fetch.

// app/api/posts/route.ts  →  /api/posts
export async function GET(request: Request) {
  const q = new URL(request.url).searchParams.get('q') ?? ''
  return Response.json(await searchPosts(q))
}

export async function POST(request: Request) {
  const body = await request.json()
  return Response.json(await createPost(body), { status: 201 })
}

• Metode suportate: GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS.
• Nu pot exista route.ts și page.tsx în același folder.
• Segmente dinamice merg la fel: app/api/posts/[id]/route.ts.

Când folosești Route Handlers

Ce este Proxy

Proxy (proxy.ts în rădăcina proiectului — fostul middleware) e cod care rulează înainte de fiecare request potrivit, înainte să ajungă la pagină. Poate redirecționa, rescrie URL-ul, modifica headere și cookie-uri, sau răspunde direct.

// proxy.ts
import { NextResponse, type NextRequest } from 'next/server'

export function proxy(request: NextRequest) {
  if (!request.cookies.has('session') && request.nextUrl.pathname.startsWith('/dashboard')) {
    return NextResponse.redirect(new URL(`/login?next=${request.nextUrl.pathname}`, request.url))
  }
}

export const config = { matcher: ['/dashboard/:path*'] }

Aplicația asta folosește proxy.ts ca să-ți dea cookie-ul anonim vid.

Ce pui în proxy — și ce nu

Pe scurt

• Route Handler = route.ts cu funcții GET/POST, Request → Response.
• Pentru webhooks și API-uri externe; formularele tale merg prin Server Actions.
• Proxy rulează înaintea request-ului: redirect, headere, cookie-uri — rapid și simplu.

Surse oficiale

• Next.js — Route Handlers
• Next.js — Proxy
• Next.js — Backend for Frontend