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

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

كيف تفكر فيه؟

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

تطبيق عملي

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

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

جرّب بنفسك

Practice

تمرين Request وResponse

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

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

الخلاصة