تخطَّ إلى المحتوى

شرح Next.js

معالِجات المسارات (API)

الدرس 19 من 25· ⏱ 1 دقائق قراءة

إنشاء مسار API

ملف route.ts داخل app/api ينشئ نقطة نهاية:

// app/api/posts/route.ts
import { NextResponse } from "next/server";

export async function GET() {
  const posts = await getPosts();
  return NextResponse.json(posts);
}

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

قراءة معاملات الاستعلام

export async function GET(request: Request) {
  const { searchParams } = new URL(request.url);
  const q = searchParams.get("q");
  // ...
}

مسارات ديناميكية

// app/api/posts/[id]/route.ts
export async function GET(req, { params }) {
  const { id } = await params;
  return NextResponse.json(await getPost(id));
}

💡 للنماذج والتعديلات داخل تطبيقك، Server Actions أبسط؛ استخدم Route Handlers لواجهات API عامّة أو للعملاء الخارجيين (تطبيق جوّال مثلًا).

🎯 التالي: الوسيط (Middleware).

هل كان هذا الدرس مفيدًا؟