الانتقال إلى المحتوى الرئيسي
GET
curl
يعيد endpoint Sync Transactions لدى Didit التغييرات التي طرأت على معاملات الاتصال منذ المؤشر المحدد: added وmodified وremoved. إذا كان المؤشر فارغًا، يعيد كل المعاملات مع reset: true. لا تخزّن next_cursor إلا بعد استجابة تحتوي على has_more: false. اطّلع على التدفق البنكي المستمر للمحاسبة.

التفويضات

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.

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

id
string<uuid>
مطلوب

معرّف الاتصال.

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

cursor
string

قيمة next_cursor التي خزّنتها. إذا كانت فارغة أو لم تُذكر، تبدأ من البداية.

limit
integer
افتراضي:100

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

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

يستمر في القراءة نفسها ما دام has_more يساوي true.

الاستجابة

صفحة من التغييرات.

التغييرات في معاملات الاتصال منذ مؤشر معيّن. المؤشر الفارغ يُرجع كل المعاملات الحالية بوصفها added. تعكس جميع صفحات القراءة الواحدة اللقطة نفسها، وتظهر التغييرات التي تحدث في الأثناء في القراءة التالية.

added
object[]
مطلوب

المعاملات المطلوب إضافتها. في القراءة الأولى (بدون مؤشر، أو بعد reset) تشمل كل معاملة كانت موجودة في الربط عند بدء القراءة، مرة واحدة فقط وبحالتها الحالية، حتى إن جرت مزامنة أثناء التصفح. وفي القراءات اللاحقة تتضمن المعاملات الجديدة منذ مؤشرك، والمعاملة المسجّلة التي تحل محل معاملة معلّقة.

modified
object[]
مطلوب

المعاملات التي تغيّرت منذ مؤشرك، بحالتها الحالية. طبّق كل معاملة كعملية إدراج أو تحديث (upsert) بحسب id: المعاملة التي استلمتها بالفعل أثناء التصفح في القراءة الأولى تعود هنا إذا تغيّرت في الأثناء، ويصل هنا أيضاً تصحيح البنك.

removed
object[]
مطلوب

المعاملات التي لم تعد موجودة، مع reason. تجاهل id غير الموجود لديك: المعاملة التي حُذفت أثناء تصفح القراءة الأولى سُلّمت مرة واحدة بوصفها added، وتصل هنا في القراءة التالية.

has_more
boolean
مطلوب

true ما دامت هناك صفحات إضافية. لا تخزّن next_cursor إلا بعد استجابة تحمل has_more: false؛ وإذا فشل التصفح في منتصفه، فأعد البدء من المؤشر الذي خزّنته سابقاً.

next_page_token
string | null
مطلوب

يستمر في هذه القراءة ما دام has_more يساوي true.

next_cursor
string | null
مطلوب

نقطة التحقق الدائمة لتدفق البيانات، وتُعاد فقط في الصفحة الأخيرة. قيمة غير شفافة ومرتبطة بالتطبيق والبيئة والاتصال. يمكن إعادة تشغيلها لمدة 90 يومًا. عند القراءة الأولى تمثل لحظة بدء القراءة، فيصل ما تغيّر في الأثناء مع القراءة التالية.

reset
boolean
مطلوب

true في كل عملية تهيئة أولية، أي كل قراءة تبدأ من مؤشر فارغ: استبدل نسختك بالنتيجة بدلاً من الإضافة إليها.

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