هيكل الاستجابة

شكل الغلاف

تُعيد جميع واجهات استدعاء القوائم غلافاً متسقاً:

{
  "count": 150,
  "results": [
    { "id": 1, "name": "..." },
    { "id": 2, "name": "..." }
  ]
}

الحقل	النوع	الوصف
count	صحيح	إجمالي عدد السجلات المطابقة عبر جميع الصفحات
results	مصفوفة	العناصر في الصفحة الحالية

count هو الإجمالي عبر جميع الصفحات — ليس فقط الصفحة التي تلقيتها. استخدمه لحساب عدد الصفحات الموجودة.

استجابات المورد الواحد

واجهات الاستدعاء للمورد الواحد (مثلاً GET /recitations/{id}/) تُعيد الكائن مباشرة بدون غلاف:

{
  "id": 7,
  "name": "حفص عن عاصم",
  "description": "تلاوة كاملة برواية حفص.",
  "publisher": { "id": 3, "name": "إتقان" },
  "reciter": { "id": 12, "name": "مشاري راشد العفاسي" },
  "riwayah": { "id": 1, "name": "حفص" }
}

---

انظر أيضاً: التصفيح · مبادئ التصميم · معالجة الأخطاء