curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=ZAF" \
-F "services=zaf_refugee" \
-F "vendor_data=user-1234" \
-F "refugee_file_number=RF123456"
{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "ZAF",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "zaf_refugee",
"service_name": "South Africa - Refugee File Verification",
"source_data": {},
"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_refugee",
"service_name": "South Africa - Refugee File Verification",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
🇿🇦 جنوب أفريقيا
التحقق من ملفات اللاجئين في جنوب أفريقيا - واجهة برمجة التطبيقات
استعلام من قاعدة بيانات جنوب أفريقيا الرسمية عبر 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_refugee" \
-F "vendor_data=user-1234" \
-F "refugee_file_number=RF123456"
{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "ZAF",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "zaf_refugee",
"service_name": "South Africa - Refugee File Verification",
"source_data": {},
"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_refugee",
"service_name": "South Africa - Refugee File Verification",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
يتحقق من رقم ملف اللاجئ مقابل سجل اللاجئين لدى وزارة الداخلية في جنوب أفريقيا. تتيح Didit هذه الخدمة عبر
POST /v3/database-validation/ لتتمكن من التحقق من البيانات المُرسلة مقابل المصدر الرسمي، واستلام نتائج مطابقة موحّدة.
التغطية
- التغطية: —
- الدولة: جنوب أفريقيا
- معرّف الخدمة:
zaf_refugee - نطاق البيانات: الهوية
- الفئة: حكومية
المدخلات
| الحقل | مطلوب | مثال |
|---|---|---|
refugee_file_number | نعم | RF123456 |
phone_number | لا | +15550101000 |
email | لا | john.doe@example.com |
vendor_data | لا | user-1234 |
- المدخلات المطلوبة:
refugee_file_number - المدخلات الاختيارية:
phone_number،email،vendor_data - الموافقة: غير مطلوبة
- توفر الخدمة في سير العمل: متاحة في سير العمل مع ربط الحقول
- التغطية: —
- السعر: $1.28 لكل استعلام ناجح
refugee_file_number على وثيقة الهوية، لذلك لا تنتجه أي خطوة بمفردها. اجمعه من إجابة في الاستبيانات، أو من حقل مستخرج بواسطة Document AI، أو من قيمة ترسلها عند إنشاء الجلسة، ثم اربطه في خطوة التحقق من قواعد البيانات. حتى يتم ربطه، يعرض محرر سير العمل هذه الخدمة معطّلة ويسمّي المدخل الناقص. وعند التشغيل، إذا كان المدخل ناقصاً فإن الفحص يُتخطّى قبل أي استعلام، فلا تُحتسب عليك تكلفة قاعدة بيانات لم يكن ممكناً الاستعلام عنها.
معاملات الجسم
string
افتراضي:"ZAF"
مطلوب
رمز الدولة وفق ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.مثال:
ZAFstring
افتراضي:"zaf_refugee"
مطلوب
مصفوفة تحتوي على معرّف هذه الخدمة. تثبيت الخدمة يُبقي الطلب مقتصراً على قاعدة البيانات هذه بالتحديد.مثال:
zaf_refugeestring
افتراضي:"RF123456"
مطلوب
قيمة
refugee_file_number المطلوبة لخدمة قاعدة البيانات هذه.مثال: RF123456string
قيمة
phone_number المطلوبة لخدمة قاعدة البيانات هذه.مثال: +15550101000string
عنوان البريد الإلكتروني.مثال:
john.doe@example.comstring
افتراضي:"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_refugee" \
-F "vendor_data=user-1234" \
-F "refugee_file_number=RF123456"
تُرجع كل استجابة ناجحة رمز 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_refugee",
"service_name": "South Africa - Refugee File Verification",
"source_data": {},
"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_refugee",
"service_name": "South Africa - Refugee File Verification",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
البيانات المُرجعة
تعتمد الحقول الدقيقة الظاهرة فيsource_data على ما يُرجعه السجل. يوثّق المثال المُولَّد لـ zaf_refugee حالياً هذا الشكل الموحّد:
- يختلف حسب استجابة السجل.
الأسعار واتفاقيات مستوى الخدمة
تُحتسب استعلامات التحقق من ملف اللاجئ في جنوب أفريقيا فقط عندما تتلقى Didit نتيجة حاسمة من مصدر التحقق.- السعر لكل استدعاء: $1.28 USD.
- الفوترة: لكل استعلام ناجح. لا تُحتسب عليك تكلفة عندما يكون السجل غير قابل للوصول، أو عندما تكون الحقول المطلوبة ناقصة، أو عندما يُرفض الطلب قبل وصوله إلى المصدر.
- زمن الاستجابة: عادةً p95 < 2 s.
- التوفر: 99.9% لكل ربع سنة من جهة Didit؛ ويختلف توفر المصدر الخارجي حسب الدولة ومجموعة البيانات.
تابع القراءة
آخر تعديل في ٧ نوفمبر ٢٠٢٦