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

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

كيف تفكر فيه؟

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

تطبيق عملي

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

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

جرّب بنفسك

Practice

تمرين استجابات JSON

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

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

الخلاصة