مقارنة الوجوه

الخطوة 1 من 3
1
المصدر
2
الهدف
3
التحليل

تحديد المصدر

التوقيع القياسي الحيوي الأساسي المستخدم للتحقق.

menu_bookمرجع API: مقارنة الوجوهexpand_more

الوثائق الرسمية: docs.verifik.co/biometrics/compare

قد تصف صفحات Verifik العامة حقولًا إضافية لبيئات أخرى. يستدعي عرض HumanAuthn هذا مسار Verifik الذي يقبل gallery وprobe وcompare_min_score الاختياري فقط.

POST /v2/face-recognition/compare

يقارن صور الاستطلاع بصور المعرض ويعيد درجة تشابه. يضبط الخادم passed عندما تلبّي الدرجة compare_min_score (أو الافتراضي عند الحذف).

العنوانالقيمة
Content-Typeapplication/json
AuthorizationBearer <token>
المعاملالنوعإلزاميالوصف
gallerystring[]نعموجه/وجوه مرجعية، base64 (بدون بادئة data URL)
probestring[]نعموجه/وجوه للمطابقة، base64
compare_min_scorenumberلا0.67 إلى 0.95. الافتراضي 0.85 عند الحذف
await fetch("https://api.verifik.co/v2/face-recognition/compare", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${accessToken}`,
  },
  body: JSON.stringify({
    gallery: ["<base64>"],
    probe: ["<base64>"],
    compare_min_score: 0.85,
  }),
});
// 200 OK, example shape
{
  "id": "…",
  "data": {
    "result": {
      "score": 0.91,
      "compare_min_score": 0.85,
      "passed": true
    },
    "compare_min_score": 0.85
  },
  "signature": {
    "message": "Certified by Verifik.co",
    "dateTime": "…"
  }
}
  • يجب أن تكون الصور حمولات base64 حقيقية. تُرفض السلاسل القصيرة جدًا (مثل 412:only_images_in_base64).
  • منزلق الحد الأدنى لنتيجة المقارنة يضبط compare_min_score في الطلب (0.67 إلى 0.95؛ يبدأ عند الافتراضي لعميل واجهة البرمجة 0.85).
  • غالبًا تتضمن الاستجابات المعرّف وكتلة توقيع إلى جانب البيانات.