التحقق من هوية
يشغل التحقق فحوص الجودة وكشف الهجمات والمطابقة واحد إلى واحد على إطارات الجلسة ويعيد قراراً واحداً.
POST
/v1/identities/{identity_id}/verifyأرسل capture_session_id كحقل نموذج. ويمكن للنظام الخلفي الموثوق إرسال الإطارات هنا باسم frames بدلاً من رفعها من التطبيق.
response
{
"id": "ver_01m...",
"object": "verification",
"identity_id": "idn_01m...",
"capture_session_id": "cap_01m...",
"environment": "live",
"decision": "manual_review",
"reason": "restricted_mode",
"retry_allowed": false,
"guidance": null,
"policy": "restricted_pilot",
"restricted_mode": true,
"identity": {
"match": true,
"similarity": 0.71,
"threshold": 0.363,
"score_semantics": "Cosine similarity between embeddings. Not a probability."
},
"pad": {
"status": "passed",
"score": 0.93,
"score_semantics": "Raw model output used for screening. Not a probability that the person is real."
},
"timings_ms": { "total_ms": 180.4 },
"model_versions": { "release": "2026-10-pilot-1" },
"request_id": "req_01m...",
"created_at": "2026-10-30T10:01:12Z"
}اللقطات السيئة نتائج طبيعية وتعود بالرمز 200 مع قرار، وكذلك الجلسات المنتهية. تعامل مع الاستجابات خارج 2xx كفشل في الطلب نفسه.
يجيب identity.match عن سؤال واحد: هل طابق الوجه؟ وقيمته true أو false، أو null إذا كانت الدرجة قريبة جداً من العتبة أو لم تُحسب. ولا يقول شيئاً عن صحة اللقطة، فاقرأ decision وreason أولاً.
قراءة النتائج لاحقاً
GET
/v1/verifications/{verification_id}GET
/v1/verifications