curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=ZAF" \
-F "services=zaf_company_directors" \
-F "vendor_data=user-1234" \
-F "company_registration_number=REG-123456"
{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "ZAF",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "zaf_company_directors",
"service_name": "South Africa - Company Directors Lookup",
"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_company_directors",
"service_name": "South Africa - Company Directors Lookup",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
🇿🇦 جنوب أفريقيا
مديرو الشركات في جنوب أفريقيا - واجهة برمجة البحث API
ابحث عن مديري الشركات في جنوب أفريقيا عبر Didit من قاعدة بيانات موثوقة. الدفع لكل استدعاء بدءاً من $0.75، دون عقود أو حد أدنى.
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_company_directors" \
-F "vendor_data=user-1234" \
-F "company_registration_number=REG-123456"
{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "ZAF",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "zaf_company_directors",
"service_name": "South Africa - Company Directors Lookup",
"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_company_directors",
"service_name": "South Africa - Company Directors Lookup",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
يُرجع المديرين الحاليين لشركة جنوب أفريقية من السجل التجاري لدى CIPC. تُتيح Didit هذه الخدمة عبر
POST /v3/database-validation/ لتتمكن من التحقق من البيانات المُرسلة مقابل المصدر الرسمي، واستلام نتائج مطابقة موحّدة.
التغطية
- التغطية: —
- الدولة: جنوب أفريقيا
- معرّف الخدمة:
zaf_company_directors - نطاق البيانات: حكومي
- الفئة: CompanyRegister
المدخلات
| الحقل | مطلوب | المثال |
|---|---|---|
company_registration_number | نعم | REG-123456 |
vendor_data | لا | user-1234 |
- المدخلات المطلوبة:
company_registration_number - المدخلات الاختيارية:
vendor_data - الموافقة: غير مطلوبة
- توفّر سير العمل: متاح في سير العمل مع ربط الحقول
- التغطية: —
- السعر: $0.75 لكل استعلام ناجح
company_registration_number على أي وثيقة هوية، لذلك لا توجد خطوة تنتجه بمفردها. اجمعه من إجابة في الاستبيان، أو من حقل مستخرج عبر Document AI، أو من قيمة ترسلها عند إنشاء الجلسة، ثم اربطه في خطوة التحقق من قواعد البيانات. وإلى أن يُربط، يعرض محرر سير العمل هذه الخدمة معطّلة ويذكر المدخل الناقص. وعند التشغيل، يعني المدخل الناقص أن الفحص يُتخطّى قبل أي استعلام، فلا تُحتسب عليك رسوم مقابل قاعدة بيانات لم يكن بالإمكان الاستعلام منها.
معلمات جسم الطلب
string
افتراضي:"ZAF"
مطلوب
رمز الدولة وفق ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.مثال:
ZAFstring
افتراضي:"zaf_company_directors"
مطلوب
مصفوفة تحتوي على معرّف هذه الخدمة. تثبيت الخدمة يُبقي الطلب مقتصرًا على قاعدة البيانات المحددة هذه تحديدًا.مثال:
zaf_company_directorsstring
افتراضي:"REG-123456"
مطلوب
قيمة
company_registration_number المطلوبة من خدمة قاعدة البيانات هذه.مثال: REG-123456string
افتراضي:"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_company_directors" \
-F "vendor_data=user-1234" \
-F "company_registration_number=REG-123456"
تُرجع كل عملية ناجحة رمز 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_company_directors",
"service_name": "South Africa - Company Directors Lookup",
"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_company_directors",
"service_name": "South Africa - Company Directors Lookup",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
البيانات المُعادة
تعتمد الحقول الدقيقة المعروضة فيsource_data على ما يُرجعه السجل. يوثّق المثال المُولَّد لـ zaf_company_directors حاليًا هذا الشكل الموحّد:
- تختلف حسب استجابة السجل.
الأسعار واتفاقيات مستوى الخدمة
تُحتسب رسوم استعلامات البحث عن مديري الشركات في جنوب أفريقيا فقط عندما تستلم Didit نتيجة حاسمة من مصدر التحقق.- السعر لكل عملية: $0.75 USD.
- الفوترة: لكل استعلام ناجح. لا تُحتسب رسوم عند تعذّر الوصول إلى السجل، أو عند غياب الحقول المطلوبة، أو عند رفض الطلب قبل وصوله إلى المصدر.
- زمن الاستجابة: زمن الاستجابة: يبلغ p95 النموذجي أقل من ثانيتين.
- التوافر: 99.9% لكل ربع سنة من جانب Didit؛ ويختلف توافر المصدر الخارجي حسب الدولة ومجموعة البيانات.
متابعة القراءة
آخر تعديل في ٧ نوفمبر ٢٠٢٦