curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=BRA" \
-F "services=bra_company_directors" \
-F "vendor_data=user-1234" \
-F "company_registration_number=11222333000181"
{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "BRA",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "bra_company_directors",
"service_name": "Brazil - Company Partners and Directors (QSA)",
"source_data": {
"directors": [
{
"document_number": "***.456.789-**",
"entity_type": "person",
"name": "MARIA EXEMPLO DA SILVA",
"role": "SOCIO-ADMINISTRADOR",
"start_date": "2010-03-15"
},
{
"document_number": "11444777000161",
"entity_type": "company",
"name": "HOLDING EXEMPLO S A",
"role": "SOCIO",
"start_date": "2018-06-01"
}
],
"registration_number": "11222333000181"
},
"validation": {}
}
]
}
🇧🇷 البرازيل
التحقق من الشركاء والمديرين في البرازيل (QSA) API
البرازيل - الشركاء والمديرون (QSA): استعلام من قاعدة بيانات برازيلية موثوقة عبر Didit. الدفع لكل استدعاء بدءاً من $0.20، دون عقود أو حد أدنى.
POST
/
v3
/
database-validation
/
curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=BRA" \
-F "services=bra_company_directors" \
-F "vendor_data=user-1234" \
-F "company_registration_number=11222333000181"
{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "BRA",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "bra_company_directors",
"service_name": "Brazil - Company Partners and Directors (QSA)",
"source_data": {
"directors": [
{
"document_number": "***.456.789-**",
"entity_type": "person",
"name": "MARIA EXEMPLO DA SILVA",
"role": "SOCIO-ADMINISTRADOR",
"start_date": "2010-03-15"
},
{
"document_number": "11444777000161",
"entity_type": "company",
"name": "HOLDING EXEMPLO S A",
"role": "SOCIO",
"start_date": "2018-06-01"
}
],
"registration_number": "11222333000181"
},
"validation": {}
}
]
}
يعيد هذا الاستعلام الشركاء والمديرين الحاليين (QSA) لشركة برازيلية من سجل الهيئة الفيدرالية للإيرادات (Receita Federal)، مع الدور الذي يشغله كل منهم وتاريخ بدايته. تُخفى أرقام CPF للأفراد كما تنشرها الهيئة. تُتيح Didit هذه الخدمة عبر
POST /v3/database-validation/ لتتمكن من التحقق من البيانات المُرسلة مقابل المصدر الرسمي، والحصول على نتائج مطابقة موحّدة.
التغطية
- التغطية: ~ 100%
- الدولة: البرازيل
- معرّف الخدمة:
bra_company_directors - نطاق البيانات: الجهات الحكومية
- الفئة: CompanyRegister
المدخلات
| الحقل | مطلوب | مثال |
|---|---|---|
company_registration_number | نعم | 11222333000181 |
vendor_data | لا | user-1234 |
- الإدخالات المطلوبة:
company_registration_number - الإدخالات الاختيارية:
vendor_data - الموافقة: غير مطلوبة
- التوفر في سير العمل: متاحة في سير العمل مع ربط الحقول
- التغطية: ~ 100%
- السعر: $0.20 لكل استعلام ناجح
company_registration_number على أي وثيقة هوية، لذلك لا توجد خطوة تنتجه بمفردها. اجمعه من إجابة في الاستبيان، أو من حقل مستخرج عبر Document AI، أو من قيمة ترسلها عند إنشاء الجلسة، ثم اربطه في خطوة التحقق من قواعد البيانات. إلى أن يُربط، يعرض محرر سير العمل هذه الخدمة معطّلة ويذكر الإدخال الناقص. وعند التشغيل، يعني الإدخال الناقص أن الفحص يُتخطى قبل أي استعلام، فلا تُحتسب عليك أي تكلفة لقاعدة بيانات لم يكن بالإمكان الاستعلام منها.
معاملات جسم الطلب
string
افتراضي:"BRA"
مطلوب
رمز الدولة وفق ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.مثال:
BRAstring
افتراضي:"bra_company_directors"
مطلوب
مصفوفة تحتوي على معرّف هذه الخدمة. تثبيت الخدمة يُبقي الطلب مقتصراً على قاعدة البيانات هذه بالتحديد.مثال:
bra_company_directorsstring
افتراضي:"11222333000181"
مطلوب
القيمة
company_registration_number التي تتطلبها خدمة قاعدة البيانات هذه.مثال: 11222333000181string
افتراضي:"user-1234"
المعرّف الثابت للمستخدم لدى نظامك، مثل معرّفك الداخلي للمستخدم. تستخدمه Didit لربط الفحوصات المستقلة بالمستخدم النهائي نفسه، ولتقليل ضوضاء اكتشاف التكرار.مثال:
user-1234قواعد الإدخال وملاحظات التحقق
- يجب أن تطابق
company_registration_numberالتعبير[0-9A-Za-z]{2}\.?[0-9A-Za-z]{3}\.?[0-9A-Za-z]{3}/?[0-9A-Za-z]{4}-?\d{2}.
كيفية الاستدعاء
curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=BRA" \
-F "services=bra_company_directors" \
-F "vendor_data=user-1234" \
-F "company_registration_number=11222333000181"
يعيد كل استدعاء ناجح الرمز HTTP
200. يوضح الحقل outcome_code ما حدث فعلاً، فيميّز مثلاً بين عدم تطابق بيومتري حقيقي (BIOMETRIC_NO_MATCH) وصورة سيلفي تعذّرت قراءتها (BIOMETRIC_IMAGE_UNUSABLE). الحالة status المعروضة هي الحالة الافتراضية للميزة، ويمكن لـإجراءات Partial Match / No Match التي تضبطها أن تتجاوزها.MATCH: أكّد السجل الهوية، وتطابق كل حقل تم فحصه.{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "BRA",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "bra_company_directors",
"service_name": "Brazil - Company Partners and Directors (QSA)",
"source_data": {
"directors": [
{
"document_number": "***.456.789-**",
"entity_type": "person",
"name": "MARIA EXEMPLO DA SILVA",
"role": "SOCIO-ADMINISTRADOR",
"start_date": "2010-03-15"
},
{
"document_number": "11444777000161",
"entity_type": "company",
"name": "HOLDING EXEMPLO S A",
"role": "SOCIO",
"start_date": "2018-06-01"
}
],
"registration_number": "11222333000181"
},
"validation": {}
}
]
}
البيانات المُرجعة
تعتمد الحقول الدقيقة التي تظهر فيsource_data على ما يعيده السجل. يوثّق المثال المولّد لـ bra_company_directors حالياً البنية الموحّدة التالية:
directorsregistration_number
الأسعار واتفاقيات مستوى الخدمة
تُحتسب استعلامات الشركاء والمديرين (QSA) في البرازيل فقط عندما تستلم Didit نتيجة حاسمة من مصدر التحقق.- سعر كل استعلام: $0.20 بالدولار الأمريكي.
- الفوترة: لكل استعلام ناجح. لا تُحتسب عليك أي تكلفة عندما يتعذر الوصول إلى السجل، أو عندما تكون الحقول المطلوبة ناقصة، أو عندما يُرفض الطلب قبل أن يصل إلى المصدر.
- زمن الاستجابة: عادةً ما يكون p95 أقل من ثانيتين.
- التوفر: 99.9% لكل ربع سنة من جانب Didit؛ ويختلف توفر المصادر الخارجية بحسب الدولة ومجموعة البيانات.
متابعة القراءة
آخر تعديل في ٧ نوفمبر ٢٠٢٦