الانتقال إلى المحتوى الرئيسي
DELETE
curl
تُوقف نقطة endpoint في Didit المخصّصة لحذف الاتصال البنكي الوصول إلى البنك، وتحذف الحسابات والأرصدة والمعاملات المخزّنة الخاصة بالاتصال. الحذف لا يمكن التراجع عنه. لإيقاف الوصول دون حذف، استخدم إلغاء الوصول. راجع البيانات والموافقة والحذف لمعرفة ما يتأثر وما لا يتأثر.

التفويضات

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.

الترويسات

Idempotency-Key
string

مفتاح اختياري لأمان إعادة المحاولة تختاره لعملية واحدة، بحد أقصى 255 حرفًا (يصلح UUID). الطلب المكرَّر بالمفتاح نفسه والـ endpoint والاستعلام والمحتوى يُجاب بالاستجابة الأولى نفسها، بالحالة والمحتوى نفسيهما، ولا يُنفَّذ ولا يُحتسب مرة ثانية. استخدام المفتاح نفسه مع endpoint أو استعلام أو محتوى مختلف يعيد 409 مع idempotency_key_reused، وبينما الطلب الأول ما زال قيد التنفيذ يعيد 409 مع idempotency_key_in_progress ومعه Retry-After. لا يُخزَّن الطلب الفاشل (أي 4xx أو 5xx)، لذا يمكنك إرساله مرة أخرى بالمفتاح نفسه. المفاتيح تخص تطبيقك، سواء استدعيت بمفتاح API أو بـ token الوصول. راجع إعادة المحاولة وidempotency.

Required string length: 1 - 255

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

id
string<uuid>
مطلوب

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

الاستجابة

تم قبول الحذف.

حذف مقبول. تجري حالياً إزالة بيانات البنك الخاصة بالاتصال، وترد عمليات البيانات عليه بـ 409 connection_not_active؛ وتُرجع قراءة الاتصال سجلاً مختصراً بحالة erasure هذه.

id
string<uuid>
مطلوب

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

erasure
object
مطلوب

تقدم عملية الحذف التي طلبتها.

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