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_registry" \
-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_registry",
"service_name": "South Africa - Company Registry 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_registry",
"service_name": "South Africa - Company Registry 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_registry" \
-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_registry",
"service_name": "South Africa - Company Registry 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_registry",
"service_name": "South Africa - Company Registry Lookup",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
تبحث هذه الخدمة عن شركة جنوب أفريقية باستخدام رقم التسجيل في السجل التجاري لدى CIPC. تتيح Didit هذه الخدمة عبر
POST /v3/database-validation/ لتتمكن من التحقق من البيانات المُرسلة مقابل المصدر الرسمي، واستلام نتائج مطابقة موحدة.
التغطية
- التغطية: -
- الدولة: جنوب أفريقيا
- معرّف الخدمة:
zaf_company_registry - نطاق البيانات: الحكومة
- الفئة: CompanyRegister
المدخلات
| الحقل | مطلوب | مثال |
|---|---|---|
company_registration_number | نعم | REG-123456 |
company_name | لا | Sample Company LLC |
vendor_data | لا | user-1234 |
- المدخلات المطلوبة:
company_registration_number - المدخلات الاختيارية:
company_name،vendor_data - الموافقة: غير مطلوبة
- توفر سير العمل: متاح في سير العمل مع ربط الحقول
- التغطية: -
- السعر: $0.75 لكل استعلام ناجح
company_registration_number على أي مستند هوية، لذلك لا توجد خطوة تنتجه بمفردها. اجمعه من إجابة في الاستبيان، أو من حقل مستخرج عبر Document AI، أو من قيمة ترسلها عند إنشاء الجلسة، ثم اربطه في خطوة التحقق من قواعد البيانات. وإلى أن يتم ربطه، يعرض محرر سير العمل هذه الخدمة معطّلة ويسمّي المدخل الناقص. وأثناء التشغيل، يعني المدخل الناقص أن الفحص يُتخطّى قبل أي استعلام، فلا تُحتسب عليك تكلفة قاعدة بيانات لم يكن بالإمكان الاستعلام منها.
معاملات الجسم
string
افتراضي:"ZAF"
مطلوب
رمز الدولة ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.مثال:
ZAFstring
افتراضي:"zaf_company_registry"
مطلوب
مصفوفة تحتوي على معرّف هذه الخدمة. تثبيت الخدمة يُبقي الطلب مقصورًا على قاعدة البيانات المحددة هذه بالذات.مثال:
zaf_company_registrystring
افتراضي:"REG-123456"
مطلوب
القيمة
company_registration_number مطلوبة من قبل خدمة قاعدة البيانات هذه.مثال: REG-123456string
القيمة
company_name مطلوبة من قبل خدمة قاعدة البيانات هذه.مثال: Sample Company LLCstring
افتراضي:"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_registry" \
-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_registry",
"service_name": "South Africa - Company Registry 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_registry",
"service_name": "South Africa - Company Registry Lookup",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
البيانات المُعادة
تعتمد الحقول الدقيقة الظاهرة فيsource_data على ما يعيده السجل. يوثّق المثال المُولَّد لـ zaf_company_registry حاليًا بنية الاستجابة الموحدة التالية:
- يختلف حسب استجابة السجل.
الأسعار واتفاقيات مستوى الخدمة
استعلامات البحث في سجل الشركات في جنوب أفريقيا لا تُحتسب إلا عندما تتلقى Didit نتيجة حاسمة من مصدر التحقق.- سعر الاستدعاء الواحد: $0.75 USD.
- الفوترة: لكل استعلام ناجح. لا تُحتسب تكلفة الاستعلام عندما يكون السجل غير قابل للوصول، أو عندما تكون الحقول المطلوبة مفقودة، أو عندما يُرفض الطلب قبل وصوله إلى المصدر.
- زمن الاستجابة: النموذجي p95 أقل من 2 ثانية.
- التوفر: 99.9% لكل ربع سنة من جهة Didit؛ ويختلف توفر المصدر النهائي حسب الدولة ومجموعة البيانات.
متابعة القراءة
آخر تعديل في ٧ نوفمبر ٢٠٢٦