القوالب البيومترية API

افتراضياً، يؤدي حذف جلسة التحقق أيضاً إلى حذف تضمين الوجه الذي كان يُستخدم في البحث بالوجه 1:N والكشف عن الوجوه المكررة لتلك الجلسة. ويمكن للتطبيقات التي تحتاج إلى استمرار الكشف عن الوجوه المكررة بعد حذف الجلسة أن تفعّل الاحتفاظ بالقالب البيومتري. عندها تحذف Didit الجلسة وجميع بياناتها كالمعتاد، ثم تحتفظ بقالب بيومتري للوجه منفصل يُدار بشكل مستقل، لا يحتوي على صور، ومرتبط بـالمستخدم الخاص بالجلسة. تتيح لك واجهة برمجة تطبيقات القوالب البيومترية أن ترى بدقة القوالب التي يحتفظ بها تطبيقك، ولماذا، وحتى متى، وأن تحذفها نهائياً في أي وقت. ويظهر كل قالب أيضاً في Business Console ضمن Lists → Biometric templates، وفي الملف الشخصي للمستخدم المالك.

القالب البيومتري المحتفَظ به بيانات بيومترية. فهو ليس مجهول الهوية، وليس مؤقتاً، ولا يُحذف مع الجلسة. يبقى حتى تنتهي صلاحيته المجدولة، أو يحين موعد نهائي أسبق يفرضه القانون المعمول به، أو يُحذف المستخدم، أو يُقدَّم طلب بمحو البيانات لأسباب تتعلق بالخصوصية، أو يُنفَّذ حذف نهائي صريح. فعّل الاحتفاظ فقط عندما تغطيه تعليمات المتحكم بالبيانات وإشعار الخصوصية لديك.

كيف يُنشأ القالب

المُشغِّل	`source_type`	مصدر التعليمات
تحذف جلسة في تطبيق مفعّل للاحتفاظ، أو ترسل `retain_face_embeddings: true` في Delete Session أو Batch Delete Sessions	`session_delete`	`instruction_source: api` أو `console`
تنتهي فترة الاحتفاظ بالبيانات العامة لتطبيقك فتنتهي معها جلسة في تطبيق مفعّل للاحتفاظ	`automatic_retention`	`instruction_source: automatic_retention`
عملية استكمال تُنفذها Didit بناءً على تعليماتك للجلسات التي حُذفت قبل أن تفعّل الاحتفاظ	`backfill`	`instruction_source: backfill`

يتطلب الاحتفاظ ربط الجلسة بمستخدم. فالجلسة التي تُنشأ دون vendor_data لا ترتبط بمستخدم، ولذلك لا يمكنها الاحتفاظ بقالب. وفي هذه الحالة يُبلغ الحذف عن ineligible_no_vendor_user، ويُحذف تضمين الوجه مع الجلسة.

ما الذي يحتويه القالب

يُحتفظ به	لا يُحتفظ به أبداً
القالب الرقمي للوجه المستخدم في المطابقة	صورة الوجه، وفيديو اختبار الحيوية، وصور المستندات، واقتطاعات الصور الشخصية، وأي وسائط أخرى
معرّف `uuid` جديد عشوائي للقالب، و`provenance_reference` مبهم	معرّف الجلسة المحذوفة أو رقمها أو قرارها أو حقول الهوية المستخلصة منها أو حمولات الميزات
المستخدم المالك (`vendor_user_uuid`)؛ ويُستخرج `vendor_data` من المستخدم عند قراءة القالب، ولا يُنسخ أبداً	حالة القائمة السوداء، والمطابقات السابقة، وتصنيفات الاحتيال، وادعاءات الهوية عبر المؤسسات
`retained_at` و`expires_at` و`retention_policy` و`retention_override` و`instruction_class` و`instruction_source` و`instruction_id` و`retained_by` و`retained_by_type`	عناوين البريد الإلكتروني للجهات الفاعلة

القوالب محصورة بالمستأجر، ولا تُستخدم إلا بناءً على تعليماتك داخل تطبيقك: للكشف عن الوجوه المكررة وكشف الحسابات المتعددة، والمصادقة البيومترية، ولقوائم الوجوه الخاصة بك. ولا تُستخدم أبداً لتدريب النماذج، أو للتحليلات، أو للمطابقة عبر المؤسسات، أو لإشارات Networks المشتركة، أو لمعالجة الاحتيال المستقلة التي تجريها Didit.

كائن القالب

{
  "uuid": "9d2f4b6e-1c3a-4e8f-b7d5-0a1c2e3f4a5b",
  "vendor_user_uuid": "2f7c1a9e-8b4d-4c6a-9e1f-3d5b7a9c1e2f",
  "vendor_data": "user-42",
  "source_type": "session_delete",
  "provenance_reference": "6b1e8d2f-4a3c-4f9e-8c7d-1a2b3c4d5e6f",
  "retention_policy": "retain_until_user_deleted",
  "retention_override": null,
  "retained_at": "2026-08-28T10:15:42.318402Z",
  "expires_at": "2027-08-28T10:15:42.318402Z",
  "retained_by": "3c9e2b1f-7d4a-4e8b-9c1d-5f6a7b8c9d0e",
  "retained_by_type": "API_KEY",
  "instruction_class": "operational_session_delete",
  "instruction_source": "api",
  "instruction_id": "post-approval-cleanup-2026-08",
  "held_out_of_use": false,
  "status": "active",
  "purged_at": null
}

الحقل	النوع	الوصف
`uuid`	UUID	معرّف القالب. يُولَّد عشوائياً، ولا يُشتق من الجلسة المحذوفة أو من وجهها.
`vendor_user_uuid`	UUID	المستخدم المالك.
`vendor_data`	string أو null	القيمة الحالية لـ `vendor_data` الخاصة بالمستخدم، وتُستخرج عند قراءة القالب.
`source_type`	enum	`session_delete` أو `automatic_retention` أو `backfill`.
`provenance_reference`	UUID	مرجع مبهم يربط القالب بسجل التدقيق الخاص به. وهو ليس معرّف الجلسة المحذوفة، ولا يمكن تحويله إليه عبر الواجهة البرمجية.
`retention_policy`	enum	سياسة التطبيق وقت الاحتفاظ: `delete_with_session` أو `retain_until_user_deleted`.
`retention_override`	boolean أو null	قيمة `retain_face_embeddings` المرسلة مع الحذف، أو `null` عندما طُبّقت السياسة.
`retained_at`	datetime	وقت إنشاء القالب.
`expires_at`	datetime	وقت انتهاء صلاحية القالب وحذفه تلقائياً. وتكون هذه القيمة مضبوطة دائماً.
`retained_by`	string	الجهة التي أصدرت التعليمة: معرّف التطبيق لمفاتيح API، أو معرّف عضو Console لإجراءات Console، أو معرّف `service:` للاحتفاظ التلقائي. ولا يكون عنوان بريد إلكتروني أبداً.
`retained_by_type`	enum	`API_KEY` أو `CONSOLE_USER` أو `SYSTEM`.
`instruction_class`	enum	`operational_session_delete` أو `privacy_erasure`.
`instruction_source`	enum	`api` أو `console` أو `automatic_retention` أو `backfill` أو `privacy_erasure` أو `explicit_template_purge` أو `vendor_user_delete` أو `expiry` أو `reconciliation` أو `migration` أو `system`.
`instruction_id`	string	قيمة `instruction_id` التي أرسلتها مع الحذف، أو معرّف تولّده Didit عندما لا ترسله.
`held_out_of_use`	boolean	تكون `true` فقط أثناء سريان حجز قانوني. ويُستبعد القالب المحجوز من كل عمليات المطابقة. راجع الحجز القانوني.
`status`	enum	حالة دورة الحياة، انظر أدناه.
`purged_at`	datetime أو null	وقت الحذف النهائي للقالب.

الحالة

`status`	المعنى	هل يدخل في المطابقة؟
`pending`	القالب قيد الإنشاء. وإذا أعاد الحذف الذي أنشأه الاستجابة `503`، فكرر الحذف لإكماله.	لا
`active`	يشارك القالب في المطابقة حتى `expires_at`.	نعم، ما لم تكن `held_out_of_use` تساوي `true`، أو كان `expires_at` قد مضى
`expired`	مضى `expires_at`، والحذف التلقائي قيد التنفيذ.	لا
`held_out_of_use`	يسري حجز قانوني على القالب.	لا
`purge_pending`	الحذف النهائي قيد التنفيذ.	لا
`purge_failed`	تعذّر إتمام الحذف النهائي لأن أحد مخازن البيانات البيومترية غير متاح. كرر الحذف النهائي؛ ويظل القالب مستبعداً من المطابقة في الأثناء.	لا
`purged`	القالب محذوف. يظهر فقط في استجابة الحذف النهائي باسم `already_purged`، والقوالب المحذوفة نهائياً لا تظهر في القوائم، وتعيد `404` عند طلب التفاصيل.	لا

كيف تُستخدم القوالب في المطابقة

يشارك القالب active في المطابقة نفسها التي يشارك فيها وجه الجلسة المباشرة: الكشف التلقائي عن التكرار أثناء الجلسات الجديدة، وواجهة برمجة التطبيقات للبحث بالوجه المستقلة، والمصادقة البيومترية، وقوائم الوجوه لديك. يُبلَّغ عن التطابق مع قالب محفوظ بالقيمة source: "retained_template"، مع vendor_user_id وvendor_data الخاصين بالمستخدم المالك، وbiometric_template_id. لا يتضمن هذا التطابق أبدًا معرّف جلسة، أو صورة مطابقة، أو تفاصيل هوية، أو حالة، لأن الجلسة التي أنتجت الوجه لم تعد موجودة. راجع تقرير البحث بالوجه. لا يُضاف القالب المحفوظ إلى قائمة الحظر أبدًا. إذا كان وجه الجلسة المحذوفة موجودًا في قائمة حظر للوجوه، فإن إدخال القائمة يحتفظ بإدخال بيومتري مستقل خاص به ودورة حياة مستقلة. إزالة إدخال القائمة تحذف إدخال قائمة الحظر، وحذف القالب لا يمس القائمة.

نقاط الحذف النهائي

تؤدي كل النقاط التالية إلى إزالة القالب من المطابقة وحذف القالب المخزَّن:

نقطة الحذف	الطريقة
الحذف الصريح	`DELETE /v3/biometric-templates/{uuid}/` أو `POST /v3/biometric-templates/delete/`، أو Lists → Biometric templates في Console
حذف المستخدم	تحذف `POST /v3/users/delete/` كل قالب مرتبط بالمستخدم قبل حذف المستخدم
المحو لأغراض الخصوصية	أي حذف لجلسة تعود إلى ذلك المستخدم ويُرسَل مع `deletion_instruction: "privacy_erasure"` يحذف كل قالب مرتبط بالمستخدم، بغض النظر عن سياسة التطبيق
الانتهاء	يحذف Didit القالب تلقائيًا بمجرد مرور الوقت المحدد في `expires_at`

إعادة سياسة التطبيق إلى delete_with_session توقف إنشاء قوالب جديدة، لكنها لا تحذف القوالب الموجودة. احذفها صراحةً. تحذف عملية الحذف النهائي القالب المخزَّن أولًا، ثم تضع علامة على القالب بأنه حُذف نهائيًا. لذلك، إذا أعادت عملية الحذف النهائي الرمز 503، يبقى القالب في الحالة purge_failed، ويكون مستبعدًا من المطابقة بالفعل، ويمكن تكرار العملية بأمان. ويعيد تكرار الحذف النهائي لقالب حُذف نهائيًا بالفعل الرمز already_purged.

سجل التدقيق

يُسجَّل كل محاولة احتفاظ وكل محاولة حذف نهائي، بما فيها الإخفاقات والنتائج غير المؤهلة، مع الجهة الفاعلة (retained_by أو الجهة المنفذة للحذف ونوعها)، وinstruction_class، وinstruction_source، وinstruction_id، وprovenance_reference، والنتيجة. أرسل instruction_id الخاص بك في عمليات الحذف حتى تتمكن من مطابقة سجل التدقيق لدى Didit مع سجل المحو لديك. لا تتضمن إدخالات التدقيق أبدًا صورًا أو متجهات أو حقول هوية أو عناوين بريد إلكتروني.

الحجوزات القانونية

الحجز القانوني استثناء، وليس وضع احتفاظ. لا يفرض Didit حجوزات من تلقاء نفسه، ولا يمكن أن يترتب الحجز إلا على تعليمات موثقة بموجب اتفاقية معالجة البيانات الخاصة بك، أو على أمر ملزم صادر عن سلطة مختصة. طوال مدة سريان الحجز يُوسم القالب بالحالة held_out_of_use، فيُستبعد من كل أنواع المطابقة ومن الاسترجاع الروتيني، ولا يمكن البحث فيه أبدًا. لا توجد واجهة برمجية لإنشاء الحجوزات أو رفعها. تواصل مع ممثل Didit لديك إذا تلقيت أمرًا يؤثر في القوالب المحفوظة.

الأذونات والمصادقة

تقبل endpoints الخاصة بالقوالب البيومترية مفاتيح API الخاصة بالتطبيق فقط (x-api-key). تُرفض رموز مستخدمي Business Console بالرمز 403. يدير مستخدمو Console القوالب من خلال Lists → Biometric templates بالصلاحيات lists الخاصة بهم.

نقاط endpoint

Endpoint	الطريقة	الغرض
`/v3/biometric-templates/`	GET	قائمة مقسّمة إلى صفحات مع عوامل التصفية
`/v3/biometric-templates/count/`	GET	العدد بعوامل التصفية نفسها
`/v3/biometric-templates/{template_uuid}/`	GET	قالب واحد
`/v3/biometric-templates/{template_uuid}/`	DELETE	حذف قالب واحد نهائيًا
`/v3/biometric-templates/delete/`	POST	الحذف النهائي بقائمة معرّفات أو بالتصفية

ذو صلة

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

​كيف يُنشأ القالب

​ما الذي يحتويه القالب

​كائن القالب

​الحالة

​كيف تُستخدم القوالب في المطابقة

​نقاط الحذف النهائي

​سجل التدقيق

​الحجوزات القانونية

​الأذونات والمصادقة

​نقاط endpoint

​ذو صلة