Skip to main content
GET
قائمة عمليات الشحن المحمول

نظرة عامة

يُرجع قائمة مرقّمة بجميع عمليات شحن الهاتف المحمول، مرتبةً من الأحدث إلى الأقدم.

معلمات الاستعلام

integer
افتراضي:1
رقم الصفحة (الحد الأدنى: 1)
integer
افتراضي:20
عدد العناصر في الصفحة (الحد الأدنى: 1، الحد الأقصى: 100)

الاستجابة

boolean
مطلوب
يشير إلى نجاح الطلب
object
مطلوب
object
مطلوب

الأمثلة

مثال على الاستجابة

حالات الاستخدام

سجل الطلبات

اعرض سجل الشحن للمستخدمين في تطبيقك

متابعة الطلبات المعلّقة

ابحث عن الشحنات ذات الحالة PENDING أو UNKNOWN_ERROR لمتابعتها

التقارير

أنشئ تقارير المبيعات والتشغيل

التدقيق

راجع جميع العمليات لأغراض المحاسبة

متابعة الطلبات المعلّقة

أمثلة على التصفية

حسب النطاق الزمني

التصفية من جهة العميل

أفضل الممارسات

  • استخدم أحجام صفحات معقولة (20-50 عنصرًا)
  • خزّن النتائج مؤقتاً عند الإمكان
  • نفّذ “تحميل المزيد” أو التمرير اللانهائي
  • استخدم pagination.totalPages لتحديد ما إذا كانت هناك صفحات إضافية
  • وفّر دائماً كلاً من from وto
  • استخدم تنسيق ISO 8601 الصحيح
  • ضع في اعتبارك المنطقة الزمنية للمستخدم عند التصفية
  • حدّد نطاقات تاريخ معقولة للأداء الأمثل
  • خزّن بيانات القائمة مؤقتاً لفترات قصيرة
  • استخدم مرشحات التاريخ للحدّ من مجموعات النتائج
  • تجنّب جلب جميع الصفحات دفعة واحدة
  • أنشئ فهرساً باستخدام created_at في قاعدة بياناتك المحلية
  • اعرض الحالة مع أيقونات/ألوان
  • نسّق الطوابع الزمنية بالمنطقة الزمنية المحلية
  • اعرض شعارات المشغّلين
  • اربط بصفحات الحالة التفصيلية
  • اعرض سبب الاسترداد للشحنات الفاشلة

Endpoints ذات الصلة

إرسال الشحن

إرسال شحن هاتف محمول

التحقق من الحالة بالمرجع

البحث بالمرجع الداخلي

قائمة الخطط

عرض الخطط المتاحة