الانتقال إلى المحتوى الرئيسي
GET
curl
الملاحظات هي الخط الزمني للمعاملة الذي يراه المحللون، وهي نفس القائمة التي يراها المراجعون ضمن ملاحظات في تفاصيل المعاملة في وحدة التحكم. أضف ملاحظاتك الخاصة باستخدام إنشاء ملاحظة معاملة، واقرأ المعاملة نفسها، بما في ذلك activities، باستخدام الحصول على المعاملة. الملاحظات التي تحمل actor_name بقيمة Rule Engine تصدر من Didit: إما إجراء add_note لقاعدة ما ضمن إجراء، أو مشكلة في إنشاء جلسة التحقق من إجراء المستخدم لمعاملة في حالة AWAITING_USER (تعذّر إنشاء الجلسة، أو لجأ Didit إلى سير عمل آخر).

التفويضات

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[]
مطلوب
آخر تعديل في ٧ نوفمبر ٢٠٢٦