الانتقال إلى المحتوى الرئيسي
GET
/
v3
/
account
/
transactions
قائمة المعاملات
curl --request GET \
  --url https://api.oneclickdz.com/v3/account/transactions \
  --header 'X-Access-Token: <api-key>'

​
نظرة عامة

يُرجع قائمة مرقّمة بجميع معاملات حسابك، بما فيها الإيداعات والسحوبات والشحنات والمبالغ المستردة والتحويلات.

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

​
page
integer
افتراضي:1
رقم الصفحة (الحد الأدنى: 1)
​
pageSize
integer
افتراضي:20
العناصر في الصفحة (الحد الأدنى: 1، الحد الأقصى: 100)
​
from
string
تاريخ البدء للتصفية (تنسيق ISO 8601: 2025-10-01T00:00:00Z)
​
to
string
تاريخ الانتهاء للتصفية (تنسيق ISO 8601: 2025-10-31T23:59:59Z)
عند التصفية حسب التاريخ، يجب توفير معلمتَي from و to معًا.

​
أنواع المعاملات

​
دخول الأموال (زيادة)

النوعالوصف
DEPOSITأموال مودعة في حسابك
REFUND-FLEXYاسترداد من شحن هاتف محمول فاشل
REFUND-ADSLاسترداد من شحن إنترنت فاشل
REFUND-ORDERاسترداد من طلب بطاقة هدية ملغى
RECEIVEأموال مستلمة من مستخدم آخر
POINT-EXCHANGEنقاط محوّلة إلى رصيد

​
خروج الأموال (تخفيض)

النوعالوصف
FLEXYمعاملة شحن هاتف محمول
ADSLمعاملة شحن إنترنت
ORDERطلب بطاقة هدية أو منتج
WITHDRAWأموال مسحوبة من الحساب
SENDأموال مرسلة لمستخدم آخر
SERVICEدفع خدمة أو رسوم

​
الاستجابة

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

​
الأمثلة

curl https://api.oneclickdz.com/v3/account/transactions?page=1&pageSize=20 \
  -H "X-Access-Token: YOUR_API_KEY"

​
مع التصفية بالتاريخ

curl "https://api.oneclickdz.com/v3/account/transactions?from=2025-10-01T00:00:00Z&to=2025-10-31T23:59:59Z" \
  -H "X-Access-Token: YOUR_API_KEY"

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

{
  "success": true,
  "data": {
    "items": [
      {
        "type": "FLEXY",
        "operation": "decrement",
        "oldBalance": 2316.129999998957,
        "amount": 990,
        "newBalance": 1326.129999998957,
        "objid": "68fe2cdd51bc170608683e3a",
        "note": "MIX1000_OOREDOO - 0554926570",
        "time": "2025-10-26T14:14:53.074Z",
        "_id": "68fe2cdd51bc170608683e40"
      },
      {
        "type": "REFUND-ORDER",
        "operation": "increment",
        "oldBalance": 316.1299999989569,
        "amount": 2000,
        "newBalance": 2316.129999998957,
        "objid": "68fcdd7cd712569c624e05ee",
        "note": "Refunded - 1 - 68fcdd7cd712569c624e05ee",
        "time": "2025-10-25T14:24:00.338Z",
        "_id": "68fcdd80d712569c624e069d"
      }
    ],
    "pagination": {
      "page": 1,
      "pageSize": 5,
      "totalPages": 105,
      "totalResults": 521
    }
  },
  "meta": {
    "timestamp": "2025-10-29T00:35:58.852Z"
  }
}

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

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

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

المحاسبة والتقارير

أنشئ تقارير ومستخرجات مالية

مطابقة الرصيد

تحقق من تغييرات الرصيد وراجع المعاملات

نشاط المستخدم

تتبع أنماط الإنفاق وسلوك المستخدمين

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

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

​
Endpoints ذات الصلة

الحصول على الرصيد

التحقق من رصيد الحساب الحالي