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

فهم مسارات API وResources وتطبيقه عمليًا داخل ميزة صغيرة في Laravel. Laravel API عقد عام؛ Routes تحدد السطح وValidation يحمي المدخلات وResources تشكل المخرجات وStatus/Error Behavior يجعل التكامل متوقعًا.

كيف تفكر فيه؟

  • في درس مسارات API وResources، النتيجة التي يجب أن تتحقق: Resource يحافظ على عقد JSON مستقلًا عن شكل Model الداخلي.
  • في سياق مسارات API وResources، الخطر الذي يجب أن يبقى تحت السيطرة: إرجاع Model Attributes أوException Messages الخام يصنع API هشًا وقد يكشف حقولًا غير مخصصة للنشر.
  • تطبيق مسارات API وResources: أنشئ JSON Endpoint مع Validation وResource ثم اختبر Success وValidation Error.
Diagram

من API Route إلى Resource

تطبيق عملي

في التطبيق الخاص بدرس مسارات API وResources: Resource يحافظ على عقد JSON مستقلًا عن شكل Model الداخلي.

app/Http/Controllers/Api/UserController.phpphp
public function index()
{
    return UserResource::collection(
        User::query()->paginate(20)
    );
}

جرّب بنفسك

Practice

تمرين مسارات API وResources

أنشئ JSON Endpoint مع Validation وResource ثم اختبر Success وValidation Error.

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

الخلاصة