كيفية مقارنة وجهين باستخدام برنامج Toden
Charles Archibong, المؤسس المشارك
قارن صورتين لوجهين عندما تحتاج إلى نتيجة مطابقة تامة. هذا الفحص منفصل عن التحقق من حيوية الصورة وعن البحث في سجل العملاء.
أهم النقاط
- يتم التعامل مع حالات المطابقة والمراجعة وعدم المطابقة وعدم وجود نتيجة في بيئة الاختبار بشكل منفصل.
- يتم تطبيق متطلبات الموافقة وحجم الصورة.
- يقوم التطبيق بتخزين وإعادة قراءة رقم التحقق.
- لا يتم عرض الحكم المُحاكى أبدًا كنتيجة مباشرة للمحرك.
قارن صورتين لوجهين عندما تحتاج إلى نتيجة مطابقة تامة. هذا الفحص منفصل عن التحقق من حيوية الصورة وعن البحث في سجل العملاء.
قبل أن تبدأ
صورتان واضحتان للوجه
إذن وموافقة لمقارنة الصور
استخدم أحد أعضاء الفريق المصرح له بالتحكم في هذا الخيار. تحقق من المؤسسة والبيئة قبل تغيير أي إعداد. راجع السعر الحالي قبل إجراء أي عملية دفع أو تجديد الاشتراك. تُظهر لقطات الشاشة مثالاً لمساحة عمل أو مرجع تكامل عام؛ ولا تُظهر عميلاً حقيقياً أو عملية دفع مكتملة.
قم بإعداد واستخدام هذه الإمكانية
الخطوة 1: افتح تطبيق مطابقة الوجوه واختر البيئة
في لوحة التحكم، افتح التحقق ← عمليات التحقق السريع ← مطابقة الوجه . اختر بيئة الاختبار لإجراء اختبارك الأول. تأكد من توفر ميزة عمليات التحقق السريع لمؤسستك وأن دورك يسمح بإجراء المقارنة. API يستخدم نفس المحرك وسجل الأحكام. يُعيد برنامج Sandbox نتائج محاكاة؛ ولا يمكنه إثبات دقة مطابقة الصور الحقيقية.
مرجع التكامل: سلوك بيئة الاختبار
الخطوة الثانية: جهّز صورتين مختلفتين وواضحتين
استخدم صورتين بموافقة الطرفين، بحيث تظهر في كل منهما ملامح وجه واضحة. JPEG ، PNG يدعم النظام تنسيقي WebP وWebP. لا ترسل الصورة نفسها مرتين. حمّل كل صورة في قسمها الخاص من نموذج مطابقة الوجوه، ثم أكّد طلب الموافقة. راجع حدود المؤسسة المعروضة بدلاً من الاعتماد على حد لكل طلب لتجاوز السياسة المسجلة.
مرجع التكامل: قارن
الخطوة 3: مراجعة العتبات وإجراء المقارنة
تحقق من عتبة المطابقة والحد الأدنى للمراجعة في مؤسستك قبل إجراء مقارنة إنتاجية مدفوعة. قم بإجراء فحص الصورتين مرة واحدة واحتفظ برقم تعريف الفحص. المطابقة هي نتيجة تقييم المحرك للتشابه عند العتبة المسجلة؛ ولا تثبت أن الشخص موجود فعليًا أو يتحكم في حساب. في حال تطلب الأمر مراجعة يدوية، قارن الصور وسجل قرارك المتعلق بالسياسة بشكل منفصل.
مرجع التكامل: الحكم
الخطوة الرابعة: دمج نفس المقارنة في الواجهة الخلفية
يتصل POST /api/kyc/face/compare باستخدام مفتاح سري وموافقة: صحيح . قدّم مصدر صورة واحد فقط لكل جانب: imageA أو mediaAId ، و imageB أو mediaBId . يمكن أن تكون الصورة عامة مدعومة. URL ، بيانات URI أو base64. بالنسبة للملفات القابلة لإعادة الاستخدام، قم بتحميلها من خلال POST قم بتحميل البيانات البيومترية من خلال الرابط /api/kyc/face/upload، ثم مرر معرفات الوسائط. احتفظ بالمدخلات البيومترية والمفاتيح السرية على جانب الخادم.
مرجع التكامل: التحميل أولاً (اختياري)
الخطوة 5: التعامل مع الأحكام الأربعة جميعها
اقرأ قيمة faceCheck.verdict ، ومستوى الثقة، والعتبات المسجلة مع هذا الفحص. التطابق يعني أنه عند مستوى النجاح أو أعلى منه؛ والمراجعة تعني أنه بين الحد الأدنى ومستوى النجاح؛ وعدم التطابق يعني أنه أقل من الحد الأدنى. عدم وجود نتيجة يعني أنه تعذر إجراء مقارنة، وبالتالي لا يتم احتساب أي رسوم. لا تقم بدمج المراجعة أو فشل الخدمة مع التطابق. يمكن احتساب رسوم على مقارنة لم يتم إجراؤها بنجاح.
مرجع التكامل: الحكم
الخطوة السادسة: استخدام السجل للمطابقة والتدقيق
قم بتخزين رقم التحقق مقابل إجراء التطبيق المقصود. استرجعه GET /api/kyc/face/checks/{id} بعد فقدان الرد أو عند مراجعة مقارنة سابقة. تقوم نقطة نهاية السجل بتصفية النتائج حسب الحكم والتاريخ وتحديد API عمليات التحقق التي تبدأها جهة معينة. إعادة قراءة نتيجة موجودة تختلف عن إجراء مقارنة أخرى؛ لا تكرر عملية التحقق المدفوعة بشكل أعمى للعثور على نتيجتها السابقة.
مرجع التكامل: التاريخ
استفد أكثر من هذه الإمكانية
اختر عتبات المراجعة كسياسة تنظيمية واحتفظ بهذه العتبات مسجلة مع كل حكم.
استخدم معرّفات التحميل عندما تكون لديك حاجة مشروعة لإعادة استخدام صورة مصرح بها، بدلاً من إرسال ملفات كبيرة مضمنة بشكل متكرر.
أضف إلى ذلك ربط الموضوع والتحقق من قبل شخص حقيقي عندما يتطلب الإجراء تأكيدًا من صاحب الحساب.
اختبر قبل الاعتماد عليه
قم بتشغيل سيناريوهات بيئة الاختبار أو المحاكاة المدعومة لهذا المنتج. في حال كانت الأداة مخصصة للإنتاج فقط، تحقق من صلاحيات الوصول ونطاقها أولاً، ثم استخدم اختبار إنتاج مسموح به وخضع لمراجعة دقيقة. لا تُعد لقطة شاشة من الوثائق أو تحميل الصفحة بنجاح اختبار تكامل شامل.
يتم التعامل مع حالات المطابقة والمراجعة وعدم المطابقة وعدم وجود نتيجة في بيئة الاختبار بشكل منفصل.
يتم تطبيق متطلبات الموافقة وحجم الصورة.
يقوم التطبيق بتخزين وإعادة قراءة رقم التحقق.
لا يتم عرض الحكم المُحاكى أبدًا كنتيجة مباشرة للمحرك.
استكشاف الأخطاء وإصلاحها
ال API يرفض صورة URL
تأكد من أن العنوان يُشير إلى عنوان عام مسموح به ويُقدم بايتات قابلة للقراءة ومدعومة.
النتيجة هي no_result
استخدم شرح الخطأ وحسّن عملية الالتقاط. هذا ليس خطأ عدم التطابق، ولم يتم احتساب أي رسوم.
تم رفض المفتاح القابل للنشر
تعتمد مقارنة الوجوه المستقلة على المفتاح السري فقط. استدعِها من نظامك الخلفي.
افتح مراجع الإعداد والتكامل
افتح أداة لوحة التحكم (يفتح في علامة تبويب جديدة)
اقرأ مرجع التكامل (يفتح في علامة تبويب جديدة)
العودة إلى الحلول (يفتح في علامة تبويب جديدة) . اختر الخاصية التي تريد تفعيلها، ثم اتبع الدليل الخاص بها.
المصادر
Charles Archibong
المؤسس المشارك
شارك تشارلز أرتشيبونغ في تأسيس شركة Toden. وهو يكتب عن التحقق من الهوية، والتكنولوجيا المالية، والعمل العملي لبناء خدمات رقمية موثوقة.
