تقرير التحقق من الهوية: الحقول ودرجات الجودة

نظرة عامة

يلتقط تقرير التحقق من الهوية كل ما استخرجته Didit وتحققت منه من مستند هوية صادر عن جهة حكومية — جوازات السفر، وبطاقات الهوية، ورخص القيادة، وتصاريح الإقامة. ويجمع الحقول الحيوية وحقول المستند المستخرجة عبر OCR، وعناوين URL الموقعة للوسائط الملتقطة، وبيانات العنوان المحللة والمحددة جغرافياً، ودرجات جودة الصورة لكل جانب، ومحتويات MRZ، وتفصيلات حسب نظام الكتابة (لاتيني / غير لاتيني)، وتطابقات المستندات عبر الجلسات المختلفة. يتم إنشاء التقرير بعد أن يكمل المستخدم خطوة التقاط المستند في سير العمل (أو يستدعي endpoint الخاص بـ OCR المستقل). وتحدد Didit نوع المستند، وتجري عملية OCR، وتتحقق من صحة MRZ / الرمز الشريطي / رمز QR، وتحلل العنوان، وتفحص المستند للكشف عن التلاعب (التقاط من شاشة، نسخة مطبوعة، التلاعب بالصورة الشخصية)، وتقارن المستند بجميع المستندات الأخرى الملتقطة في تطبيقك. يحمل كل تقرير status خاصة به — مستقلة عن حالة الجلسة العامة — تعكس النتيجة التي انتهت إليها خطوة الهوية وحدها:

مقبولة — تم التعرف على المستند، واستخراج جميع الحقول المطلوبة، ولم يتم إطلاق أي تحذير موجّه للرفض.
قيد المراجعة — تم إطلاق تحذير واحد أو أكثر ويوجهها سير العمل لديك إلى المراجعة.
مرفوضة — تم إطلاق شرط رفض تلقائي (مستند غير مدعوم، مستند منتهي الصلاحية، الصورة الشخصية مفقودة، تطابق مع قائمة الحظر، فشل في التحقق التكيفي من العمر) أو تم إطلاق تحذير تم ضبط إجرائه على الرفض (الحد الأدنى/الأقصى للعمر مضبوطان افتراضياً على الرفض).
منتهية الصلاحية — انقضى expiration_date الخاص بالمستند بعد التحقق. تغيّر المراقبة المستمرة لانتهاء الصلاحية لدى Didit حالة التقرير من Approved إلى Expired، وتُرفق تحذير DOCUMENT_EXPIRED، وتنقل الجلسة المقبولة إلى حالة الجلسة Kyc Expired.
لم تكتمل — لم يكمل المستخدم خطوة الالتقاط أبداً.

أين يظهر في استجابات API

يأتي تقرير التحقق من الهوية داخل مصفوفة id_verifications[] — دائماً كمصفوفة JSON، وليس ككائن id_verification مفرد أبداً. وتظهر عدة إدخالات عندما يشغّل سير العمل أكثر من خطوة مستند واحدة (على سبيل المثال، هوية أساسية بالإضافة إلى خطوة تصعيدية).

API قرار الجلسة — تعيد GET /v3/session/{sessionId}/decision/ مصفوفة id_verifications[] في المستوى الأعلى. راجع استرداد قرار الجلسة.
webhook — تتضمن payload الخاصة بـ session.status.updated مصفوفة id_verifications[] نفسها بمجرد أن تُنتج الخطوة بيانات. راجع webhook.
API الخاص بـ OCR المستقل — يؤدي إرسال المستند المباشر إلى إرجاع كائن id_verification مفرد بنفس الحقول. راجع API الخاص بـ OCR المستقل.

اقرأ response.id_verifications[0] وقم بالمرور على عناصر المصفوفة. يتوفر شكل id_verification المفرد فقط في API الخاص بـ OCR المستقل — ولا يتوفر في endpoint الخاص بقرار v3.

المخطط

يوجد المخطط المرجعي الكامل حقلاً بحقل في صفحة نماذج البيانات. تأتي الحقول الموضحة أدناه مباشرةً من IDVerificationV3Serializer، الذي يوسّع IDVerificationV2Serializer ويضيف node_id، ومصفوفة matches[] عبر الجلسات، ومصفوفة document_selfie_face_matches[] للالتقاط الصامت.

الحقول على المستوى الأعلى

الحقل	النوع	الوصف
`status`	`"Approved" \| "Declined" \| "In Review" \| "Expired" \| "Not Finished"`	حالة خطوة التحقق من المستند.
`node_id`	string \| null	عقدة مخطط سير العمل التي أنتجت هذا التقرير.
`document_type`	`"Passport" \| "Identity Card" \| "Driver's License" \| "Residence Permit" \| "Health Insurance Card" \| "Tax Card" \| "Social Security Card" \| "Work Permit" \| "Visa" \| "Public Service Card" \| "Birth Certificate" \| "Firearm License" \| "Other" \| null`	فئة المستند الرئيسية المعترف بها (قابلة للقراءة البشرية).
`document_subtype`	string \| null	كود النوع الفرعي للمستند من سجل مستندات Didit، مصفيّاً وفقاً لما تقبله إعدادات المستندات في سير العمل. تتضمن المستندات الخاصة بمنطقة معينة اسم المنطقة، على سبيل المثال `QUEENSLAND_DRIVER_LICENSE_GENERIC`. راجع الأنواع الفرعية للمستندات للحصول على قائمة الأكواد الكاملة، بما في ذلك كيفية التمييز بين رخصة القيادة التجارية الأمريكية (CDL) والرخصة القياسية.
`document_number`	string	رقم المستند المستخرج عبر OCR. بالنسبة لرخص القيادة التي يُطبع عليها رقم الرخصة ورقم البطاقة معاً، راجع الملاحظة أسفل الجدول.
`personal_number`	string	الرقم التعريفي الشخصي / الوطني المستخرج عبر OCR، عندما يكون مختلفاً عن رقم المستند.
`portrait_image`, `front_image`, `front_video`, `back_image`, `back_video`, `full_front_image`, `full_back_image`	string (عنوان URL موقّع)	الوسائط الملتقطة. عناوين URL هذه موقّعة ومحددة بوقت — نزّلها على الفور ولا تقم بتخزين عنوان URL أبداً.
`front_image_camera_front`, `back_image_camera_front`	string (عنوان URL موقّع) \| null	الإطارات الملتقطة بواسطة الكاميرا الأمامية للمستخدم أثناء التقاط المستند. تُستخدم لفحص الوجه عبر الكاميرتين ومقارنتها مع قائمة حظر الوجوه الخاصة بك؛ يمكن أيضاً إضافة كل منها إلى قائمة حظر الوجوه.
`front_image_camera_front_face_match_score`, `back_image_camera_front_face_match_score`	float (0–100) \| null	درجة التطابق بين إطار الكاميرا الأمامية والصورة الشخصية على المستند.
`document_selfie_face_matches`	array \| null	الجلسات السابقة أو مدخلات قائمة حظر الوجوه التي تطابق وجوهُها صورة السيلفي الملتقطة أثناء التقاط المستند (البحث بالوجه عبر الالتقاط الصامت). له نفس تنسيق المدخلات في `liveness_checks[].matches`؛ حيث يكون `match_image_url` عبارة عن عنوان URL موقّع مسبقاً تنتهي صلاحيته. تكون القيمة `null` للجلسات القديمة أو عندما لم يتم تشغيل البحث، وتكون `[]` عند تشغيله وعدم العثور على أي تطابق.
`front_image_quality_score`, `back_image_quality_score`	object \| null	تقييم الجودة لكل جانب (راجع درجات جودة الصورة).
`document_liveness`	object \| null	درجات حيوية المستند لكل نوع من أنواع الاحتيال، مع الحدود التي تم الحكم عليها وفقاً لها (راجع درجات حيوية المستند). الإصدار V3 فقط.
`date_of_birth`, `expiration_date`, `date_of_issue`	string (YYYY-MM-DD)	تواريخ المستند.
`age`	number	عمر حامل المستند بالسنوات، محسوباً من `date_of_birth`.
`issuing_state`	string (ISO 3166-1 alpha-3)	كود دولة الإصدار.
`issuing_state_name`	string	اسم الدولة المحلي.
`first_name`, `last_name`, `full_name`	string	اسم حامل المستند بنظام الكتابة المحدد عبر `preferred_characters` (راجع أدناه).
`gender`	`"M" \| "F" \| "U"`	الجنس، إذا كان متوفراً في المستند (`U` = غير معروف).
`address`, `formatted_address`	string	سلاسل العنوان الخام والمحوّل جغرافياً/المنسّق.
`place_of_birth`	string	مكان الميلاد المستخرج عبر OCR.
`marital_status`	`"SINGLE" \| "MARRIED" \| "DIVORCED" \| "WIDOWED" \| "UNKNOWN"`	الحالة الاجتماعية، إذا كانت متوفرة في المستند.
`nationality`	string (ISO 3166-1 alpha-3)	جنسية حامل المستند، عندما تكون مختلفة عن دولة الإصدار.
`extra_fields`	object	بيانات إضافية خاصة بالمستند (فئات رخصة القيادة، فصيلة الدم، الأسماء بنظام كتابة بديل، `tax_number`، إلخ).
`mrz`	object \| null	حقول المفتاح/القيمة المحللة من MRZ.
`parsed_address`	object \| null	عنوان منظم ومحوّل جغرافياً (`street_1`، `street_2`، `city`، `region`، `country`، `postal_code`، `address_type`، `formatted_address`، `document_location`، `raw_results`، `is_best_match`).
`extra_files[]`	مصفوفة من عناوين URL موقّعة	صور إضافية مرفقة بهذا المستند.
`matches[]`	array	تطابقات المستند عبر الجلسات (راجع التطابقات عبر الجلسات).
`warnings[]`	array	تحذيرات على مستوى الوحدة — راجع تحذيرات التحقق من الهوية.

يكون issuing_state دائماً على مستوى الدولة، وليس على مستوى دون وطني مطلقاً. بالنسبة لجميع أنواع المستندات، بما في ذلك رخص القيادة الصادرة عن ولاية أو مقاطعة (أستراليا، الولايات المتحدة، كندا)، يوضح الحقلان issuing_state و issuing_state_name الدولة (على سبيل المثال AUS / Australia)، وليس الولاية. القيمة دون المستوى الوطني، عندما يتضمنها المستند، تكون متوفرة بشكل منفصل في parsed_address.region (مع الرجوع إلى extra_fields.state في بعض أنواع المستندات). وتعرض نظرة عامة على الجلسة في Business Console ذلك كصف Region أسفل Issuing state عند توفرها.

رخص القيادة التي تحمل رقمين (أستراليا). تطبع الرخص الأسترالية كلاً من رقم الرخصة، الذي يحدد الأهلية للقيادة لحاملها ويظل ثابتاً عند استبدال البطاقة، ورقم البطاقة، الذي يحدد البطاقة الفعلية ويتغير مع كل إعادة إصدار. بالنسبة لهذه الرخص، تعيّن Didit الأرقام دائماً بالطريقة نفسها:

personal_number — رقم الرخصة
document_number — رقم البطاقة

ينطبق هذا على جميع الولايات والأقاليم الأسترالية (NSW و VIC و QLD و WA و SA و TAS و ACT و NT). في بعض الإصدارات، يُطبع رقم البطاقة على الجانب الخلفي فقط، لذا لا يُقرأ إلا عند التقاط الجزء الخلفي من الرخصة. وعند تعذر قراءة رقم البطاقة، يتم تسجيل رقم الرخصة كـ document_number و personal_number معاً، بحيث يحمل document_number دائماً معرّفاً بمجرد انتهاء التحقق. وتكون قيمة personal_number هي رقم الرخصة في كلتا الحالتين. أما في أنواع المستندات الأخرى، فيظل document_number هو الرقم الأساسي المستخرج عبر OCR وقد يكون بحد ذاته معرّفاً على مستوى حامل المستند.

رقم CUIL الأرجنتيني يكون في extra_fields.tax_number، وليس في personal_number مطلقاً. تطبع المستندات الأرجنتينية رقم CUIL — وهو المعرّف المكوّن من 11 رقماً والذي تعتمد عليه AFIP وANSES ومكاتب الائتمان — في موضع مختلف في كل مستند، وتطبع بطاقة DNI رقماً آخر مكوّناً من 11 رقماً بجواره:

في رخصة القيادة، يكون رقم CUIL هو ما يحمله حقل personal_number؛
في بطاقة DNI، يحمل حقل personal_number ما يُعرف بـ número de trámite، والذي يحدد طلب البطاقة وليس معرّفاً لحاملها. ويُقرأ رقم CUIL الخاص ببطاقة DNI من حقله المطبوع المخصص له.

لذا فإن personal_number ليس رقم CUIL موثوقاً للأرجنتين: فهو في بطاقة DNI عبارة عن رقم من 11 رقماً لن يُرجع أي نتيجة بصمت من أي سجل. اقرأ extra_fields.tax_number بدلاً من ذلك. وتبلّغ عنه Didit فقط عندما يتم التحقق من صحة القيمة كرقم CUIL حقيقي (بادئة الشخص متبوعة برقم التحقق باستخدام حساب باقي القسمة على 11)، بأرقام قياسية دون فواصل (27111111117)، أياً كان المستند الأرجنتيني الذي قدّمه حامله. وعند تعذّر قراءة رقم CUIL الخاص بالبطاقة، يكون المفتاح غير موجود بدلاً من ملئه برقم لا يمثّل CUIL — التقط رخصة القيادة كمستند ثانٍ، أو اجمع رقم CUIL عبر إجابة استبيان أو من خلال metadata الخاصة بالجلسة، لتغطية هؤلاء المستخدمين.

درجات جودة الصورة

يُرجع كلٌّ من front_image_quality_score وback_image_quality_score:

الحقل	النوع	ما يقيسه
`focus_score`	number 0–100	الوضوح — تباين Laplacian المحلي لأعلى 10%، مع مقاومة للخلفيات الموحدة. الوزن 45%.
`brightness_score`	number 0–100	يفرض خفضاً للدرجة على الصور شديدة الإعتام أو المعرضة للضوء بشكل مفرط. الوزن 30%.
`brightness_issue`	`"ok" \| "too_dark" \| "too_bright"`	اتجاه مشكلة السطوع، عندما تكون `brightness_score` منخفضة.
`resolution_score`	number 0–100	يستند إلى إجمالي عدد وحدات البكسل في اللقطة. الوزن 25%.
`is_document_fully_visible`	boolean \| null	`true` عندما تكون جميع زوايا المستند الأربع مرئية، و`false` عند اقتطاع أي زاوية، و`null` عندما يتعذّر كشف الزوايا.
`overall_score`	number 0–100	مركب مرجح (التركيز 45%، السطوع 30%، الدقة 25%).

استخدم overall_score كفحص سريع للملاءمة — تشير الدرجات الأعلى من 70 عموماً إلى لقطة جيدة بما يكفي لإجراء تحقق موثوق به.

درجات حيوية المستند

يُبلّغ حقل document_liveness عما قاسه فحص حيوية المستند، سواء أثار تحذيراً أم لا. لا يظهر التحذير إلا عندما تنخفض الدرجة عن أحد حدود سير العمل، لذا قبل هذا الحقل لم يكن المستند المقبول يحمل أي دليل على الحيوية على الإطلاق - والحقل هو وسيلتك لتدقيق جلسة تم اجتيازها. وتكون قيمته null عندما لا يعمل الفحص (على سبيل المثال، طريقة لا تعتمد على المستندات، أو انقطاع في النموذج مسجل في سجلات الجلسة). وهو يحمل كائناً واحداً لكل نوع من أنواع الاحتيال - portrait_replace وprinted_copy وscreen_replay - يحتوي كل منها على:

الحقل	النوع	المعنى
`score`	number 0–100 \| null	احتمالية أن يكون المستند أصلياً لهذا النوع من الاحتيال (كلما ارتفعت الدرجة = زادت احتمالية كونه أصلياً). وهي القيمة الأدنى بين جانبي المستند، وهي القيمة التي اعتمد عليها القرار. وتكون `null` عندما لا يُنتج أيٌّ من الجانبين درجة صالحة للاستخدام - على سبيل المثال، تُسقط درجة الصورة الشخصية على جانب لم يُعثر فيه على صورة شخصية.
`front`، `back`	number 0–100 \| null	الدرجة لكل جانب ملتقط على حدة. وتكون `null` للجانب الذي لم يتم التقاطه أو الذي أُسقطت درجته.
`decline_threshold`، `review_threshold`	number \| null	الحدود المحفوظة عندما قيّمت عقدة التحقق من الهوية هذا المستند. لا تؤدي التعديلات اللاحقة على سير العمل إلى تغييرها. وتكون `null` عندما يتعذّر الوصول إلى أدلة التقييم التاريخية.
`bucket`	`"approve" \| "review" \| "decline" \| null`	أين تقع `score` مقارنة بتلك الحدود: أقل من `decline_threshold` ← `decline`، وأقل من `review_threshold` ← `review`، وإلا فـ `approve`. وتكون `null` عند عدم وجود درجة صالحة للاستخدام، أو عدم تطبيق الفحص، أو تعذّر الوصول إلى أدلة التقييم التاريخية. يصف التصنيف فحص نوع الاحتيال هذا، وليس حالة الجلسة الإجمالية.

"document_liveness": {
  "portrait_replace": {
    "score": 96.46,
    "front": 96.46,
    "back": 98.2,
    "decline_threshold": 35,
    "review_threshold": 70,
    "bucket": "approve"
  },
  "printed_copy": {
    "score": 91.2,
    "front": 91.2,
    "back": 93.7,
    "decline_threshold": 35,
    "review_threshold": 77,
    "bucket": "approve"
  },
  "screen_replay": {
    "score": 99.9,
    "front": 99.9,
    "back": 99.5,
    "decline_threshold": 30,
    "review_threshold": 70,
    "bucket": "approve"
  }
}

بالنسبة للمستندات الأقدم التي لا تتضمن أدلة تقييم محفوظة، تظل الدرجات المخزنة مرئية ولكن كلاً من الحدود وbucket تكون null. ولا تُستخدم إعدادات سير العمل الحالية مطلقاً لإعادة بناء نتيجة تاريخية. وينطبق الأمر نفسه على اللقطة التي لم يكتمل تقييم مستندها بعد. تعرض Business Console الصفوف الثلاثة نفسها في قسم حيوية المستند ضمن قسم التحقق من الهوية للجلسة.

التطابقات عبر الجلسات

تسرد matches[] ما يصل إلى 5 مستندات أخرى في تطبيقك تطابق هذا المستند — نفس تاريخ الميلاد، ونفس دولة الإصدار، والاسم الكامل متطابق بدرجة عالية. تتطلب المستندات المدرجة في قائمة الحظر بالإضافة إلى ذلك تطابقاً تاماً في رقم المستند. وتُستثنى الجلسات التي تنتمي إلى نفس المستخدم (نفس vendor_data). يتضمن كل إدخال session_id وsession_number وvendor_data وverification_date وuser_details (name وdocument_type وdocument_number) وstatus وis_blocklisted (true عندما يُضاف المستند إلى قائمة الحظر الخاصة بك) وapi_service وfront_image_url موقّعاً.

قيم الحالة

الحالة	المعنى	التأثير اللاحق
`Approved`	تم التعرف على المستند، واستخراج الحقول المطلوبة، واجتياز جميع الفحوصات وفق الحدود التي تم ضبطها.	يُحتسب كفحص هوية ناجح.
`In Review`	تم إطلاق تحذير واحد أو أكثر ويوجه سير العمل هذه التحذيرات إلى المراجعة.	تنتقل الجلسة أيضاً إلى `In Review` حتى يتخذ المراجِع إجراءً.
`Declined`	تم إطلاق شرط الرفض التلقائي (مستند غير مدعوم، مستند منتهي الصلاحية، الصورة الشخصية مفقودة، العثور على المستند في قائمة الحظر، فشل التقدير التكيفي للعمر) أو تم إطلاق تحذير تم ضبطه على الرفض.	تصبح الجلسة مرفوضة ما لم يحقق فرع آخر مقبول متطلبات سير العمل.
`Expired`	تاريخ انتهاء صلاحية المستند انقضى بعد الموافقة. يتم تعيينها بواسطة المراقبة المستمرة للمستندات من Didit، والتي تكون مفعلة افتراضياً (يُستثنى من ذلك الدولة ونوع المستند اللذان تم ضبط Expiration mode لهما على Allow expired)، مع تحذير `DOCUMENT_EXPIRED`.	تنتقل الجلسة المقبولة إلى `Kyc Expired`.
`Not Finished`	ترك المستخدم خطوة الالتقاط.	لم يُسفر فرع الهوية عن نتيجة.

المستندات متعددة أنظمة الكتابة (لاتينية / غير لاتينية)

بعض المستندات — مثل القيرغيزية والكازاخستانية والروسية واليابانية والكورية والصينية والعربية والتايلاندية وغيرها — تطبع اسم حامل المستند أو عنوانه أو مكان ميلاده بكل من النسخ اللاتيني ونظام الكتابة المحلي. يمكنك اختيار نظام الكتابة الذي يملأ الاستجابة ذات المستوى الأعلى باستخدام إعداد سير العمل (أو الـ API المستقل) preferred_characters:

القيمة	تملأ حقول المستوى الأعلى بـ	يذهب نظام الكتابة المقابل إلى
`latin` (افتراضي)	النسخ اللاتيني المطبوع على المستند	`extra_fields.*_non_latin`
`non_latin`	قيم نظام الكتابة المحلي المطبوعة على المستند	`extra_fields.*_latin`

توجد قيم نظام الكتابة البديل داخل extra_fields تحت مفاتيح ذات لواحق: first_name_non_latin، وlast_name_non_latin، وmiddle_name_non_latin، وfull_name_non_latin، وaddress_non_latin، وplace_of_birth_non_latin (أو متغيرات _latin المطابقة لها).

متى تظهر حقول نظام الكتابة البديل

فقط عندما يكون كلا نظامي الكتابة موجودين بالفعل على المستند. إذا تم استخراج حقل OCR مسمى اسمياً “Surname-Kyrgyz (Cyrillic)” كنص بنظام الكتابة اللاتيني (حروف متجانسة شكلياً أو نسخ لاتيني)، فإنه لا يُعد بديلاً غير لاتيني ويتم حذف هذا المفتاح.
تتم دائماً إعادة بناء full_name_non_latin (وكذلك full_name_latin) من مكوّنات الاسم الأول والاسم الأوسط واسم العائلة كلٌّ على حدة عندما يكون كلاهما متاحاً — حيث يتم تجاهل حقل “Full Name” الخام من الـ OCR لضمان الاتساق.
عندما يكون preferred_characters=latin ولكن المستند يحمل نصاً غير لاتيني فقط (بحيث تنتهي حقول المستوى الأعلى بكونها غير لاتينية)، تجري Didit مرحلة نسخ حرفي وتوفر first_name_latin، وlast_name_latin، وmiddle_name_latin، وfull_name_latin، وplace_of_birth_latin، وaddress_latin كبديل احتياطي لاتيني.

{
  "first_name": "John",
  "last_name": "Doe",
  "full_name": "John Doe",
  "extra_fields": {
    "first_name_non_latin": "Айна"
  }
}

المفتاح last_name_non_latin غير موجود لأن حقل المستند “Surname (Cyrillic)” ظهر بأحرف لاتينية في هذه العينة — لم يكن هناك اسم عائلة غير لاتيني حقيقي لاستخراجه.

أمثلة

Approved — بطاقة هوية إسبانية سليمة (جميع الحقول)

{
  "id_verifications": [
    {
      "status": "Approved",
      "document_type": "Identity Card",
      "document_subtype": "ID_CARD_GENERIC",
      "document_number": "SAMPLE-DOC-12345",
      "personal_number": "SAMPLE-PER-12345",
      "portrait_image": "https://<media-host>/.../portrait.jpg?signature=...",
      "front_image": "https://<media-host>/.../front.jpg?signature=...",
      "front_video": "https://<media-host>/.../front.mp4?signature=...",
      "back_image": "https://<media-host>/.../back.jpg?signature=...",
      "back_video": "https://<media-host>/.../back.mp4?signature=...",
      "full_front_image": "https://<media-host>/.../full_front.jpg?signature=...",
      "full_back_image": "https://<media-host>/.../full_back.jpg?signature=...",
      "front_image_camera_front": null,
      "back_image_camera_front": null,
      "front_image_camera_front_face_match_score": null,
      "back_image_camera_front_face_match_score": null,
      "front_image_quality_score": {
        "focus_score": 85.3,
        "brightness_score": 92.1,
        "brightness_issue": "ok",
        "is_document_fully_visible": true,
        "resolution_score": 72.4,
        "overall_score": 84.6
      },
      "back_image_quality_score": {
        "focus_score": 79.1,
        "brightness_score": 90.5,
        "brightness_issue": "ok",
        "is_document_fully_visible": true,
        "resolution_score": 72.4,
        "overall_score": 81.5
      },
      "date_of_birth": "1990-01-01",
      "age": 35,
      "expiration_date": "2031-06-02",
      "date_of_issue": "2021-06-02",
      "issuing_state": "ESP",
      "issuing_state_name": "Spain",
      "first_name": "John",
      "last_name": "Doe",
      "full_name": "John Doe",
      "gender": "M",
      "address": "Avda de Madrid 34",
      "formatted_address": "Avda de Madrid 34, Madrid, Madrid 28822, Spain",
      "place_of_birth": "Madrid",
      "marital_status": "SINGLE",
      "nationality": "ESP",
      "extra_fields": {},
      "mrz": {
        "document_number": "SAMPLE-DOC-12345",
        "surname": "DOE",
        "name": "JOHN",
        "birth_date": "900101",
        "expiry_date": "310602"
      },
      "parsed_address": {
        "street_1": "Avda de Madrid 34",
        "street_2": null,
        "city": "Madrid",
        "region": "Madrid",
        "country": "ES",
        "postal_code": "28822",
        "address_type": "Avda",
        "formatted_address": "Avda de Madrid 34, Madrid, Madrid 28822, Spain",
        "document_location": { "latitude": 40.4168, "longitude": -3.7038 },
        "raw_results": {
          "geometry": {
            "location": { "lat": 40.4168, "lng": -3.7038 },
            "location_type": "ROOFTOP"
          }
        },
        "is_best_match": true
      },
      "extra_files": [],
      "warnings": [],
      "node_id": "id_primary",
      "matches": []
    }
  ]
}

In Review — لم يتم اكتشاف رمز QR على مستند يجب أن يحتوي عليه

موجز — الاستجابة الحقيقية تحمل دائماً مجموعة الحقول الكاملة الموضحة أعلاه.

{
  "id_verifications": [
    {
      "status": "In Review",
      "node_id": "id_primary",
      "document_type": "Identity Card",
      "document_subtype": "ID_CARD_GENERIC",
      "document_number": "SAMPLE-DOC-12345",
      "first_name": "John",
      "last_name": "Doe",
      "full_name": "John Doe",
      "warnings": [
        {
          "feature": "ID_VERIFICATION",
          "risk": "QR_NOT_DETECTED",
          "additional_data": null,
          "log_type": "warning",
          "short_description": "QR not detected",
          "long_description": "The system couldn't find or read the QR code on the document. This could be due to poor image quality or an unsupported document type.",
          "node_id": "id_primary"
        }
      ]
    }
  ]
}

ملاحظة أمنية

عناوين URL الموقعة التي يتم إرجاعها لصور المستندات ومقاطع الفيديو هي عناوين مؤقتة — تنتهي صلاحيتها بعد فترة صلاحية محدودة. تعامل معها على أنها قصيرة الأجل: قم بتنزيل ما تحتاجه على الفور ولا تقم بتخزينها مؤقتاً أو عرضها علناً. عادةً ما يحتاج تطبيقك فقط إلى status، وعدد قليل من الحقول البيوغرافية، والتحذيرات — خزّن أقل قدر ممكن لتقليل مساحة التعرض لأي اختراق مستقبلي.

المصادقة

التحقق

المراقبة

المنصة

تقرير التحقق من الهوية: الحقول ودرجات الجودة

نظرة عامة

أين يظهر في استجابات API

المخطط

الحقول على المستوى الأعلى

درجات جودة الصورة

درجات حيوية المستند

التطابقات عبر الجلسات

قيم الحالة

المستندات متعددة أنظمة الكتابة (لاتينية / غير لاتينية)

متى تظهر حقول نظام الكتابة البديل

أمثلة

Approved — بطاقة هوية إسبانية سليمة (جميع الحقول)

In Review — لم يتم اكتشاف رمز QR على مستند يجب أن يحتوي عليه

ملاحظة أمنية

مواضيع ذات صلة

​نظرة عامة

​أين يظهر في استجابات API

​المخطط

​الحقول على المستوى الأعلى

​درجات جودة الصورة

​درجات حيوية المستند

​التطابقات عبر الجلسات

​قيم الحالة

​المستندات متعددة أنظمة الكتابة (لاتينية / غير لاتينية)

​متى تظهر حقول نظام الكتابة البديل

​أمثلة

​Approved — بطاقة هوية إسبانية سليمة (جميع الحقول)

​In Review — لم يتم اكتشاف رمز QR على مستند يجب أن يحتوي عليه

​ملاحظة أمنية

​مواضيع ذات صلة

نظرة عامة

أين يظهر في استجابات API

المخطط

الحقول على المستوى الأعلى

درجات جودة الصورة

درجات حيوية المستند

التطابقات عبر الجلسات

قيم الحالة

المستندات متعددة أنظمة الكتابة (لاتينية / غير لاتينية)

متى تظهر حقول نظام الكتابة البديل

أمثلة

Approved — بطاقة هوية إسبانية سليمة (جميع الحقول)

In Review — لم يتم اكتشاف رمز QR على مستند يجب أن يحتوي عليه

ملاحظة أمنية

مواضيع ذات صلة