لماذا يهم هذا الدرس؟

فهم Route Handlers واستخدامه بصورة صحيحة داخل مشروع App Router. تعرض Route Handlers عقود HTTP من App Router. تحتاج External API Calls إلى Methods وStatus Codes وValidation وTimeouts وحماية Secrets على الخادم.

كيف تفكر فيه؟

  • في درس Route Handlers، النتيجة التي يجب أن تتحقق: اجعل عقد Route Handler واضحًا في method وstatus وbody.
  • في سياق Route Handlers، الخطر الذي يجب أن يبقى تحت السيطرة: استخدام Route Handlers كProxy رقيقة بلا Validation أوTimeout ينقل عقدًا خارجيًا غير موثوق خلف URL الخاص بك فقط.
  • تطبيق Route Handlers: أنشئ GET Health Handler وExternal-service Adapter تتحقق من Upstream Response وتحول الفشل إلى Status ثابت.
Diagram

Route Handler

تطبيق عملي

في التطبيق الخاص بدرس Route Handlers: اجعل عقد Route Handler واضحًا في method وstatus وbody.

app/api/health/route.tstypescript
export async function GET() {
  return Response.json({ ok: true }, { status: 200 });
}

جرّب بنفسك

Practice

تمرين Route Handlers

أنشئ GET Health Handler وExternal-service Adapter تتحقق من Upstream Response وتحول الفشل إلى Status ثابت.

  • سجل النتيجة المتوقعة قبل التنفيذ
  • اختبر حالة صحيحة وحالة فشل مرتبطة بالدرس
  • اشرح في سطرين أين يوجد الحد المسؤول عن القرار

الخلاصة