ترقيم الصفحات

ترقيم الصفحات

لا يدعم ترقيم الصفحات في واجهة التكامل الحالية إلا GET /api/integrations/reports/raw-responses. تعيد بيانات الاستبيانات وملخصات التقارير والاستجابات والاستخدام مصفوفات كاملة أو كائنًا واحدًا ولا تقبل معاملات ترقيم.

معاملات الطلب

أضف هذه المعاملات على نقطة الاستجابات الخام فقط:

تُطبّع القيم بدل رفضها: ترفع page إلى 1 على الأقل، وتُحصر pageSize بين 1 و100.

غلاف الاستجابة

تعيد نقطة الاستجابات الخام مصفوفة JSON مباشرة، من دون بيانات صفحة أو عدد إجمالي:

[
  { "id": 123, "surveyId": 45, "answerCount": 10, "files": [] }
]

لا تستخدم خدمة تقارير التكامل الحالية غلاف مجموعة.

التكرار عبر جميع الصفحات

لعدم إرجاع totalPages، استمر حتى تحتوي الصفحة على صفوف أقل من الحجم المطلوب:

page = 1
page_size = 100
all_items = []

while True:
    response = call_api(page=page, page_size=page_size)
    all_items.extend(response)
    if len(response) < page_size:
        break
    page += 1

النتائج الفارغة

إذا لم توجد نتائج، تعيد نقطة النهاية HTTP 200 مع [].

ملاحظات

• تُطبّع القيم خارج النطاق ولا يعيد هذا الإجراء HTTP 400 بسببها.
• لا يوجد ضمان لقطة أو عدد إجمالي؛ وقد تزحزح الإدخالات المتزامنة صفحات الإزاحة. وعند تساوي createdAt يبقى الترتيب حتميًا باستخدام id الفريد تنازليًا.
• لا تتوفر حاليًا فلاتر submittedAfter أوsubmittedBefore أو الاستبيان.