الانتقال إلى المحتوى الرئيسي
DELETE
curl
يُطهّر قالبًا واحدًا: يُزال من جميع أنواع المطابقة، ويُحذف القالب المخزَّن. التطهير غير قابل للتراجع، ويُسجَّل في سجل التدقيق مع الجهة المنفذة.

دلالات إعادة المحاولة

يحذف Didit القالب المخزَّن أولاً، ثم يضع علامة على القالب بأنه مُطهَّر. إذا كان المخزن البيومتري غير متاح، يعيد الاستدعاء 503، وينتقل القالب إلى status: purge_failed، ويكون مستبعدًا من المطابقة بالفعل. كرّر الاستدعاء نفسه لإكمال التطهير.

الأخطاء

نقاط التطهير الأخرى

تُطهَّر القوالب أيضًا عند حذف المستخدم المالك لها عبر Batch Delete Users، وعند حذف أي جلسة لذلك المستخدم باستخدام deletion_instruction: "privacy_erasure"، وتلقائيًا عند expires_at. راجع نقاط التطهير.

التفويضات

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.

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

template_uuid
string<uuid>
مطلوب

معرّف القالب، كما يتم إرجاعه في biometric_template_uuid بواسطة endpoints حذف الجلسة، أو biometric_template_id عند وجود نتيجة مطابقة في البحث بالوجه، أو endpoint القائمة.

مثال:

"9d2f4b6e-1c3a-4e8f-b7d5-0a1c2e3f4a5b"

الاستجابة

نتيجة التطهير.

uuid
string<uuid>
outcome
enum<string>
الخيارات المتاحة:
purged,
already_purged
آخر تعديل في ٧ نوفمبر ٢٠٢٦