الانتقال إلى المحتوى الرئيسي
GET
curl

التفويضات

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.

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

limit
integer
افتراضي:50

حجم الصفحة. القيمة الافتراضية 50 عند إغفاله. لا يوجد حد أقصى مفروض، ولكن حافظ على صغر حجم الصفحات لتقليل زمن الاستجابة.

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

إزاحة تستند إلى الصفر للسجل الأول المراد إرجاعه. يُفضل اتباع رابط next من الصفحة السابقة.

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

إرجاع المعاملات فقط التي يكون تحويل Travel Rule الخاص بها بهذه الحالة بالضبط (على سبيل المثال ON_HOLD أو AWAITING_COUNTERPARTY). يتبع count عملية التصفية هذه؛ بينما يستمر total_transactions في عد كل معاملة في التطبيق.

assignee
string

مفصولة بفواصل؛ وتتطابق المعاملة عندما تستوفي أي قيمة. القيمة unassigned هي ما لم يتم تعيينه لأحد بعد، والقيمة rules هي ما قررته القواعد بمفردها دون مراجِع، ويطابق البريد الإلكتروني للعضو المراجِع المعيّن لها. تشير me إلى المراجِع المسجل دخوله في Console، لذا فإن مفتاح API الذي يرسل me يتلقى الرمز 400.

الاستجابة

قائمة مقسمة إلى صفحات بملخصات المعاملات، الأحدث أولاً.

count
integer

عدد المعاملات المطابقة بحد أقصى (دقيق حتى 100، ومحدد بسقف بعد ذلك). استخدم total_transactions لمعرفة العدد الفعلي عند استخدام تقسيم الصفحات.

next
string | null

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

previous
string | null

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

total_transactions
integer

العدد الإجمالي الدقيق للمعاملات (غير المحذوفة) للتطبيق. موجود في الاستجابات المقسمة إلى صفحات.

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