الانتقال إلى المحتوى الرئيسي
GET
curl
تُعيد واجهة API لسجل تسليم Travel Rule من Didit كل إدخال تسليم لمعاملة ما، مقسّمةً إلى صفحات من الأقدم إلى الأحدث. استخدم x-api-key الخاص بك مع إذن قراءة المعاملات. transaction_id هو معرّف UUID للمعاملة في Didit. إذا لم يُعثر على المعاملة أو عملية التحويل، تُعيد الواجهة 404؛ وإذا كان الإذن غير كافٍ، تُعيد 403.

التقسيم إلى صفحات وترتيب النتائج

تحتوي الاستجابة على count وnext وprevious وresults. القيمة الافتراضية لـ limit هي 100 والحد الأقصى لها 100، أما offset فقيمته الافتراضية صفر ولا يجوز أن تتجاوز 1,000,000، وتُرجع الاستجابة 400 عند تجاوزها ذلك. عادةً ما يقتصر count على 100، ولا يمثل إجمالياً موثوقاً للسجلات التاريخية الأكبر حجماً. تابع next حتى يصبح null، بصرف النظر عن قيمة count. تُرتَّب العناصر حسب وقت الإنشاء، ثم حسب المعرّف عند التساوي. يحتوي كل عنصر على uuid وkind وstatus وrail وcreated_at وdelivered_at وdetail_lines. تأخذ rail إحدى القيم EMAIL أو TRP أو INTERNAL أو NETWORK أو null، وتكون قبل الاختيار بلا قيمة. تصف detail_lines نوع الرسالة وحالتها، دون الأخطاء الخام أو payloads النقل.

السجل المضمّن

تتضمّن تفاصيل المعاملة أحدث 100 إدخال فقط في travel_rule.deliveries، مرتّبة من الأقدم إلى الأحدث. يخبرك الحقل deliveries_truncated ما إذا كانت إدخالات أقدم قد استُبعدت. تُغفِل قوائم المعاملات هذين الحقلين الخاصين بالسجل. ويظل الحقل الموجود delivery يصف أحدث تسليم. راجع التسليم وإعادة المحاولة لمعرفة معاني الحالات. رسائل الطرف المقابل هي endpoint منفصل للمحادثة.

التفويضات

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 التي تملك التحويل.

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

limit
integer
افتراضي:100

عدد الإدخالات في كل صفحة. القيمة الافتراضية 100، والقيم الأكبر تُخفَّض إلى 100؛ والقيمة التي تتجاوز 1,000,000 تعيد 400.

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

عدد الإدخالات المراد تخطيها، بحد أقصى 1,000,000. تُرجع القيمة الأكبر من ذلك الرمز 400.

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

الاستجابة

سجل التسليم المقسّم إلى صفحات، من الأقدم إلى الأحدث.

count
integer
مطلوب

يُحدَّد العدد عادةً بحد أقصى قدره 100، وليس إجمالياً موثوقاً للسجلات الأكبر حجماً. تابع next حتى تصبح القيمة null، بغض النظر عن count.

النطاق المطلوب: x >= 0
next
string<uri> | null
مطلوب

عنوان URL للصفحة التالية، أو null.

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

عنوان URL للصفحة السابقة، أو null.

results
object[]
مطلوب

الإدخالات مرتبة من الأقدم إلى الأحدث حسب وقت الإنشاء، ثم حسب المعرّف.

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