الانتقال إلى المحتوى الرئيسي
GET
curl
يقرأ endpoint List Transactions في Didit معاملات الحساب لنطاق تاريخ محدد، سواء كانت مُرحّلة أو معلّقة، ويستخدم ترقيم الصفحات باستخدام page-token. تُرسل المبالغ كسلاسل نصية عشرية، والحقول التي لا يرسلها البنك تكون null. وللحفاظ على نسخة محدَّثة، استخدم قناة التغييرات بدلاً من إعادة قراءة النطاقات.

التفويضات

x-api-key
string
header
مطلوب

مفتاح API الخاص بتطبيقك، ويمكن الحصول عليه من Developers -> API keys في Business Console. يملك المفتاح الأساسي صلاحية وصول كاملة. يمكن تقييد المفتاح المسمّى: بلا صلاحية، أو قراءة، أو كتابة لكل مورد، ويمكن قصره على بعض سير العمل أو على الجلسات المعتمدة، وعلى قائمة من عناوين IP، وعلى تاريخ انتهاء. يعني الرمز 401 أن المفتاح غير صحيح أو ملغى أو منتهي الصلاحية. ويعني الرمز 403 أنه لم يُرسل أي مفتاح، أو أن المفتاح لا يملك صلاحية لهذا المورد أو الإجراء، أو أن الطلب صدر من عنوان خارج قائمة IP الخاصة به. ويعني الرمز 404 على مسار جلسة أن الجلسة خارج سير عمل المفتاح أو حالاته المسموح بها. يتلقى المفتاح الذي لا يملك وصولًا إلى الوسائط عناوين URL للصور والفيديو وملفات PDF بقيمة null، ويتلقى المفتاح الذي لا يملك صلاحية كتابة الجلسات روابط الجلسات والرموز بقيمة null. راجع https://docs.didit.me/console/api-keys.

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

account_id
string<uuid>
مطلوب

معرّف الحساب.

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

date_from
string<date>

تاريخ بداية السريان الأول المشمول، ويُحتسب ضمنه.

date_to
string<date>

آخر تاريخ سريان يُشمل في النطاق، شاملاً. لا يوجد حد أعلى عند تركه.

status
enum<string>

المعاملات المُرحّلة أو المعلقة فقط. القيمة الافتراضية: كلاهما.

الخيارات المتاحة:
booked,
pending
limit
integer
افتراضي:100

حجم الصفحة، من 1 إلى 500. القيمة الافتراضية 100.

النطاق المطلوب: 1 <= x <= 500
page_token
string

قيمة next_page_token الخاصة بالصفحة السابقة.

الاستجابة

صفحة من المعاملات.

صفحة من نتائج قراءة لنطاق زمني. تحدد الصفحة الأولى المعاملات المشمولة، ويُعرض كل معاملة بحالتها الحالية. المعاملة التي تُحذف أثناء التصفح تختفي من الصفحات اللاحقة ويُبلغ عنها عبر تغذية التغييرات.

items
object[]
مطلوب

مرتبة تنازلياً حسب effective_date، ثم حسب id.

next_page_token
string | null
مطلوب

يستمر في هذه القراءة. يثبّت لقطة الصفحة الأولى، ويبقى صالحاً ساعة واحدة، ويرتبط بالتطبيق والبيئة والحساب وعوامل التصفية الخاصة بهذه القراءة.

has_more
boolean
مطلوب
آخر تعديل في ٢٢ نوفمبر ٢٠٢٦