curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=ZAF" \
-F "services=zaf_dha_fingerprint_match" \
-F "vendor_data=user-1234" \
-F "consent=true" \
-F "national_id=SAMPLE-NID-12345" \
-F "right_thumb=RIGHT_THUMB_TEMPLATE" \
-F "left_thumb=LEFT_THUMB_TEMPLATE"
{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "ZAF",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "zaf_dha_fingerprint_match",
"service_name": "South Africa - DHA Fingerprint Match",
"source_data": {
"identification_number": "SAMPLE-ID-12345"
},
"validation": {
"identification_number": "full_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "ZAF",
"match_type": "no_match",
"validations": [
{
"outcome_code": "NO_MATCH",
"service_id": "zaf_dha_fingerprint_match",
"service_name": "South Africa - DHA Fingerprint Match",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
🇿🇦 جنوب أفريقيا
مطابقة الهوية عبر بصمات الأصابع DHA في جنوب أفريقيا
مطابقة بصمات الأصابع مع قاعدة بيانات DHA الرسمية في جنوب أفريقيا عبر Didit، بدءاً من $1.28 لكل استدعاء، دون عقود أو حد أدنى.
POST
/
v3
/
database-validation
/
curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=ZAF" \
-F "services=zaf_dha_fingerprint_match" \
-F "vendor_data=user-1234" \
-F "consent=true" \
-F "national_id=SAMPLE-NID-12345" \
-F "right_thumb=RIGHT_THUMB_TEMPLATE" \
-F "left_thumb=LEFT_THUMB_TEMPLATE"
{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "ZAF",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "zaf_dha_fingerprint_match",
"service_name": "South Africa - DHA Fingerprint Match",
"source_data": {
"identification_number": "SAMPLE-ID-12345"
},
"validation": {
"identification_number": "full_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "ZAF",
"match_type": "no_match",
"validations": [
{
"outcome_code": "NO_MATCH",
"service_id": "zaf_dha_fingerprint_match",
"service_name": "South Africa - DHA Fingerprint Match",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
يتحقق من صور بصمات الأصابع المقدَّمة مقابل سجل بصمات الأصابع لدى Department of Home Affairs. تتيح Didit هذه الخدمة عبر
POST /v3/database-validation/ لتتمكن من التحقق من البيانات المرسلة مقابل المصدر الرسمي، والحصول على نتائج مطابقة موحَّدة.
التغطية
- التغطية: -
- الدولة: جنوب أفريقيا
- معرّف الخدمة:
zaf_dha_fingerprint_match - نطاق البيانات: بيومتري
- الفئة: الحكومة
المدخلات
| الحقل | مطلوب | مثال |
|---|---|---|
national_id | نعم | SAMPLE-NID-12345 |
right_thumb | نعم | RIGHT_THUMB_TEMPLATE |
left_thumb | نعم | LEFT_THUMB_TEMPLATE |
vendor_data | لا | user-1234 |
- المدخلات المطلوبة:
national_idوright_thumbوleft_thumb - المدخلات الاختيارية:
vendor_data - الموافقة: مطلوبة
- توفر سير العمل: واجهة API المستقلة فقط
- التغطية: -
- السعر: $1.28 دولار أمريكي لكل استعلام ناجح
right_thumb وleft_thumb، وهما قيمتان لا تنتجهما أي خطوة في سير العمل، لذلك تتوفر فقط عبر واجهة API المستقلة، حيث تزوّدها بالقيم مباشرةً.
معاملات الجسم
string
افتراضي:"ZAF"
مطلوب
رمز الدولة وفق ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.مثال:
ZAFstring
افتراضي:"zaf_dha_fingerprint_match"
مطلوب
مصفوفة تحتوي على معرّف هذه الخدمة. تثبيت الخدمة يُبقي الطلب مقتصرًا على قاعدة البيانات المحددة هذه بالذات.مثال:
zaf_dha_fingerprint_matchboolean
افتراضي:"true"
مطلوب
الموافقة الصريحة من المستخدم النهائي على هذه الخدمة.مثال:
truestring
افتراضي:"SAMPLE-NID-12345"
مطلوب
رقم الهوية الوطنية لهذه الخدمة.مثال:
SAMPLE-NID-12345string
افتراضي:"RIGHT_THUMB_TEMPLATE"
مطلوب
قيمة
right_thumb التي تتطلبها خدمة قاعدة البيانات هذه.مثال: RIGHT_THUMB_TEMPLATEstring
افتراضي:"LEFT_THUMB_TEMPLATE"
مطلوب
قيمة
left_thumb التي تتطلبها خدمة قاعدة البيانات هذه.مثال: LEFT_THUMB_TEMPLATEstring
افتراضي:"user-1234"
المرجع الثابت للمستخدم لدى نظامك لهذا الشخص، مثل معرّف المستخدم الداخلي. تستخدمه Didit لربط الفحوصات المستقلة بالمستخدم النهائي نفسه، وتقليل الضوضاء الناتجة عن اكتشاف التكرار.مثال:
user-1234قواعد الإدخال وملاحظات التحقق
- أرسل الحقول المذكورة أعلاه تمامًا كما جُمعت من المستخدم أو المستند.
- تتحقق Didit من الحقول المطلوبة قبل استدعاء قاعدة البيانات. الطلبات المرفوضة قبل الوصول إلى المصدر لا تُحتسب.
كيفية الاستدعاء
curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=ZAF" \
-F "services=zaf_dha_fingerprint_match" \
-F "vendor_data=user-1234" \
-F "consent=true" \
-F "national_id=SAMPLE-NID-12345" \
-F "right_thumb=RIGHT_THUMB_TEMPLATE" \
-F "left_thumb=LEFT_THUMB_TEMPLATE"
يعيد كل استدعاء ناجح رمز الحالة HTTP 200. يوضح الحقل outcome_code ما حدث فعليًا، فيميّز مثلًا بين عدم تطابق بيومتري حقيقي (BIOMETRIC_NO_MATCH) وصورة سيلفي تعذّرت قراءتها (BIOMETRIC_IMAGE_UNUSABLE). الحالة status المعروضة هي حالة الميزة الافتراضية، ويمكن لإجراءاتك المُعدّة في إجراءات التطابق الجزئي / عدم التطابق أن تتجاوزها.MATCH — أكد السجل الهوية، وتطابق كل حقل جرى فحصه.{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "ZAF",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "zaf_dha_fingerprint_match",
"service_name": "South Africa - DHA Fingerprint Match",
"source_data": {
"identification_number": "SAMPLE-ID-12345"
},
"validation": {
"identification_number": "full_match"
}
}
]
}
NO_MATCH — لم يُرجع السجل أي تطابق للبيانات المرسلة.{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "ZAF",
"match_type": "no_match",
"validations": [
{
"outcome_code": "NO_MATCH",
"service_id": "zaf_dha_fingerprint_match",
"service_name": "South Africa - DHA Fingerprint Match",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
البيانات المُرجَعة
تعتمد الحقول الدقيقة الظاهرة فيsource_data على ما يعيده السجل. يوثّق المثال المُولَّد للخدمة zaf_dha_fingerprint_match حاليًا هذا الشكل الموحَّد:
identification_number
الأسعار واتفاقيات مستوى الخدمة (SLAs)
تُحتسب استعلامات DHA Fingerprint Match في جنوب أفريقيا فقط عندما تتلقى Didit نتيجة حاسمة من مصدر التحقق.- السعر لكل استدعاء: $1.28 دولار أمريكي.
- الفوترة: لكل استعلام ناجح. لا تُحتسب أي رسوم عندما يتعذر الوصول إلى السجل، أو عند غياب الحقول المطلوبة، أو عند رفض الطلب قبل وصوله إلى المصدر.
- زمن الاستجابة: المعتاد عند النسبة المئوية 95 (p95) أقل من ثانيتين.
- التوفر: 99.9% لكل ربع سنة من جهة Didit؛ ويختلف توفر المصدر التابع حسب الدولة ومجموعة البيانات.
مواصلة القراءة
آخر تعديل في ٧ نوفمبر ٢٠٢٦