إطار Next.js

Route Handlers المتقدمة: Webhooks و CORS والبث

28 دقيقة الدرس 47 من 80

Route Handlers المتقدمة: Webhooks و CORS والبث

هذا الدرس يوسّع مسار Next.js بموضوع متقدم من توثيق Next.js الرسمي. الهدف ليس حفظ خيار أو اسم ملف فقط، بل فهم أثره على العرض والتخزين المؤقت والأمان والنشر.

بعد هذا الدرس ستكون قادراً على تطبيق الموضوع داخل مشروع حقيقي، اختيار حدوده الصحيحة، وشرحه كقرار هندسي قابل للمراجعة.

المفاهيم الأساسية

تصدير دوال HTTP
التحقق من الجسم الخام
رؤوس CORS
استجابات البث
اختيار Runtime للواجهات

مثال عملي

// app/api/webhooks/provider/route.ts
import { headers } from 'next/headers'
import { NextResponse } from 'next/server'

export async function POST(request: Request) {
  const body = await request.text()
  const signature = (await headers()).get('x-signature')
  if (!signature || !verifySignature(body, signature)) {
    return NextResponse.json({ error: 'Invalid signature' }, { status: 401 })
  }
  await handleWebhook(JSON.parse(body))
  return NextResponse.json({ received: true })
}

يرتبط هذا الدرس بموضوعات من توثيق Next.js الرسمي: Route Handlers, NextResponse, and runtime API docs.

لماذا يهم؟

عند بناء تطبيقات إنتاجية، يؤثر هذا الموضوع على سرعة الصفحة، ثبات البيانات، وضوح الصلاحيات، وسهولة التشغيل بعد النشر.

خطوات العمل

حدد هل البيانات عامة أم خاصة بالمستخدم.
اختر أقل جزء من الشجرة يحتاج هذا السلوك.
اربط المثال بمسار حقيقي واكتب فحصاً بسيطاً له.
وثّق أثر القرار على التخزين المؤقت والنشر.

تطبيق عملي

طبّق هذا الموضوع في ميزة صغيرة ثم راجع سلوكها محلياً وبعد البناء. ركّز على الحدود، التخزين المؤقت، الأخطاء، وتجربة المستخدم.

لا تطبّق هذا النمط على كامل التطبيق دون سبب واضح. ابدأ بحد صغير، اختبر النتيجة، ثم وسّع الاستخدام عند الحاجة.

الخلاصة

احكم على نجاح التطبيق من خلال وضوح القرار، صحة السلوك بعد البناء، وسهولة تتبعه في الإنتاج.