الانتقال إلى المحتوى الرئيسي
GET
curl
تُربط المعاملات ذات الصلة عبر vendor_data الذي ترسله لكل طرف عند إرسال المعاملة. أرسل نفس vendor_data للشخص أو الشركة نفسها في كل مرة، وسيعيد هذا endpoint السجل الكامل للمعاملات حول أي معاملة بعينها، وهي القائمة نفسها التي يطّلع عليها المراجعون تحت المعاملات ذات الصلة في تفاصيل المعاملة داخل وحدة التحكم. يحمل كل نتيجة بنية الملخص نفسها الموجودة في عرض المعاملات. استدعِ الحصول على المعاملة باستخدام uuid الخاص بالنتيجة للحصول على أطرافها وتنبيهاتها وعمليات تشغيل القواعد الخاصة بها.

التفويضات

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

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

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

transaction_id
string<uuid>
مطلوب

معرّف UUID لمعاملة Didit: وهو uuid الذي تُرجعه POST /v3/transactions/ وGET /v3/transactions/. لا يُقبل txn_id الخاص بك.

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

limit
integer
افتراضي:50

عدد المعاملات لكل صفحة. القيمة الافتراضية هي 50. أي قيمة ليست عدداً صحيحاً موجباً تعود تلقائياً إلى 50؛ وتُرجع القيمة التي تتجاوز 1000000 الرمز 400.

النطاق المطلوب: 1 <= x <= 1000000
offset
integer
افتراضي:0

موضع يستند إلى الصفر للمعاملة الأولى المراد إرجاعها. يُفضل اتباع next. القيمة التي ليست عدداً صحيحاً غير سالب ترجع تلقائياً إلى 0؛ والقيمة التي تزيد عن 1000000 تُرجع 400.

النطاق المطلوب: 0 <= x <= 1000000

الاستجابة

صفحة من المعاملات ذات الصلة، الأحدث أولاً.

count
integer
مطلوب

عدد المعاملات ذات الصلة: دقيق حتى 100، ويقتصر على 100 كحد أقصى بعد ذلك. تتبّع next بدلاً من حساب الصفحات بناءً عليه.

next
string<uri> | null
مطلوب

رابط URL مطلق للصفحة التالية، أو null في الصفحة الأخيرة.

previous
string<uri> | null
مطلوب

رابط URL مطلق للصفحة السابقة، أو null في الصفحة الأولى.

results
object[]
مطلوب
آخر تعديل في ٧ نوفمبر ٢٠٢٦