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

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

كيف تفكر فيه؟

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

تطبيق عملي

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

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

جرّب بنفسك

Practice

تمرين التكامل مع APIs خارجية

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

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

الخلاصة