شرح صفوف ومحتوى الفقرة
نادراً ما تُرجع واجهات الخوادم الاحترافية مصفوفة عارية في الجذر الأعلى؛ لأن الواجهة تحتاج أيضاً لمعرفة إجمالي الصفحات ورقم الصفحة الحالية. لذا تُغلّف القائمة داخل كائن مظروف (Envelope Object) مثل response.items:
| نمط هيكلة الرد | شكل نص JSON | قابلية التوسع المستقبلي |
|---|---|---|
| مصفوفة جذرية مباشرة | [{"id": 1}, {"id": 2}] | يتعذر إرفاق بيانات ترقيم الصفحات دون كسر العملاء |
| كائن مظروف قياسي | {"total": 2, "items": [{"id": 1}]} | مرن ويقبل إضافة حقول وصفية جديدة بأمان تام |