الانتقال إلى المحتوى الرئيسي
GET
curl
يُعيد الـ endpoint «الحصول على تشغيل مزامنة» من Didit تشغيل مزامنة واحدًا مع نتيجته لكل حساب ومورد: عدد العناصر المضافة والمعدَّلة والمحذوفة، أو الخطأ. يأتي sync_id من تحديث الاتصال أو من الـ webhook bank.data.updated.

التفويضات

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>
مطلوب

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

sync_id
string<uuid>
مطلوب

معرّف تشغيل المزامنة.

الاستجابة

تشغيل المزامنة.

مزامنة واحدة لربط. تُدرج المزامنات الأولية والمجدولة والمطلوبة فقط.

id
string<uuid>
مطلوب
connection_id
string<uuid>
مطلوب
trigger
enum<string>
مطلوب
الخيارات المتاحة:
initial,
scheduled,
requested
status
enum<string>
مطلوب
الخيارات المتاحة:
queued,
running,
succeeded,
partial,
failed
started_at
string<date-time> | null
مطلوب
finished_at
string<date-time> | null
مطلوب
results
object[]
مطلوب

ما الذي نفّذته عملية التشغيل، لكل حساب ومورد.

error
object | null
مطلوب

سبب فشل التشغيل ككل. القيمة null عندما لا يفشل. أخطاء الحسابات والموارد الفردية موجودة في results.

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