قائمة المعاملات
الحساب
قائمة المعاملات
الحصول على قائمة مرقّمة بمعاملات الحساب مع تصفية اختيارية حسب التاريخ
GET
قائمة المعاملات
نظرة عامة
يُرجع قائمة مرقّمة بجميع معاملات حسابك، بما فيها الإيداعات والسحوبات والشحنات والمبالغ المستردة والتحويلات.معلمات الاستعلام
integer
افتراضي:1
رقم الصفحة (الحد الأدنى: 1)
integer
افتراضي:20
العناصر في الصفحة (الحد الأدنى: 1، الحد الأقصى: 100)
string
تاريخ البدء للتصفية (تنسيق ISO 8601:
2025-10-01T00:00:00Z)string
تاريخ الانتهاء للتصفية (تنسيق ISO 8601:
2025-10-31T23:59:59Z)عند التصفية حسب التاريخ، يجب توفير معلمتَي
from و to معًا.أنواع المعاملات
دخول الأموال (زيادة)
خروج الأموال (تخفيض)
الاستجابة
boolean
مطلوب
يشير إلى نجاح الطلب
object
مطلوب
object
مطلوب
الأمثلة
مع التصفية بالتاريخ
مثال على الاستجابة
حالات الاستخدام
سجل المعاملات
اعرض سجل المعاملات للمستخدمين في تطبيقك
المحاسبة والتقارير
أنشئ تقارير ومستخرجات مالية
مطابقة الرصيد
تحقق من تغييرات الرصيد وراجع المعاملات
نشاط المستخدم
تتبع أنماط الإنفاق وسلوك المستخدمين
أفضل الممارسات
التصفح بالصفحات
التصفح بالصفحات
- ابدأ بأحجام صفحات معقولة (20 إلى 50 عنصرًا)
- نفّذ التمرير اللانهائي أو التنقل بين الصفحات
- خزّن النتائج مؤقتًا لتقليل استدعاءات API
- استخدم
pagination.totalPagesلتحديد ما إذا كانت هناك بيانات إضافية
التصفية بالتاريخ
التصفية بالتاريخ
- قدّم دائمًا معلمتَي
fromوtoمعًا - استخدم تنسيق ISO 8601 للتواريخ - حدد نطاقات زمنية مناسبة للتقارير - خذ بعين الاعتبار اختلافات المنطقة الزمنية عند التصفية
الأداء
الأداء
- خزّن بيانات المعاملات محليًا إذا أمكن - استخدم فلاتر التاريخ للحد من مجموعات النتائج
- نفّذ واجهة مستخدم مناسبة للتصفح بالصفحات - فكّر في إشعارات webhook للتحديثات الفورية
العرض للمستخدمين
العرض للمستخدمين
- اعرض نوع المعاملة بلغة سهلة للمستخدم
- اعرض المبالغ بتنسيق العملة المناسب
- أدرج الطوابع الزمنية بالمنطقة الزمنية المحلية
- ربط المعاملات بالكائنات المرتبطة (الشحنات، الطلبات)
Endpoints ذات الصلة
الحصول على الرصيد
التحقق من رصيد الحساب الحالي

