الانتقال إلى المحتوى الرئيسي
POST
يتحقق من البيانات مقابل قاعدة بيانات مجمّعة للتسجيلات الانتخابية. يوفّر Didit هذه الخدمة عبر POST /v3/database-validation/ لتتمكن من التحقق من البيانات المُرسلة مقابل المصدر الموثوق والحصول على نتائج مطابقة موحّدة. صيغة الإدخال: يقبل tax_number رقم CPF البرازيلي (11 رقمًا بالضبط).

التغطية

  • التغطية: ~ 95%
  • الدولة: البرازيل
  • معرّف الخدمة: bra_residential
  • نطاق البيانات: العنوان
  • الفئة: سكني

المدخلات

  • المدخلات المطلوبة: first_name، last_name، date_of_birth، address.street_1، address.postal_code، tax_number
  • المدخلات الاختيارية: address.street_2، address.city، address.region، vendor_data
  • الموافقة: غير مطلوبة
  • التوفر في سير العمل: متاح في سير العمل
  • التغطية: ~ 95%
  • السعر: $0.59 لكل استعلام ناجح
لا يحتوي كل مستند تقبله هذه الخدمة على المعرّف الذي تُجرى به عملية الاستعلام. عندما لا يُستخرج المعرّف من المستند، تُسجَّل الفحوصات على أنها غير قابلة للتطبيق، ولا يُستعلم عن أي قاعدة بيانات ولا يُحتسب أي رسوم، وهذا يمثل في بعض الدول نسبة كبيرة من المستخدمين الفعليين. لتغطيتهم، اجمع المعرّف أيضًا من إجابة في الاستبيانات، أو من حقل استخراج في Document AI، أو من قيمة ترسلها عند إنشاء الجلسة، وقم بربطه في خطوة التحقق من قواعد البيانات.

معاملات الجسم

string
افتراضي:"BRA"
مطلوب
رمز الدولة وفق ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.مثال: BRA
string
افتراضي:"bra_residential"
مطلوب
مصفوفة تحتوي على معرّف هذه الخدمة. تثبيت الخدمة يُبقي الطلب مقصورًا على قاعدة البيانات المحددة هذه.مثال: bra_residential
string
افتراضي:"John"
مطلوب
الاسم الأول المراد التحقق منه.مثال: John
string
افتراضي:"Doe"
مطلوب
اسم العائلة المراد التحقق منه.مثال: Doe
string
افتراضي:"1990-01-01"
مطلوب
تاريخ الميلاد بصيغة YYYY-MM-DD.مثال: 1990-01-01
object
مطلوب
كائن عنوان سكني منظم. استخدم street_1 وstreet_2 وcity وregion وpostal_code وcountry. ما زال يُقبل عنوان نصي كامل من الصيغة القديمة، لكن لا يُنصح به.مثال: {"street_1":"123 Sample Street","street_2":"Unit 4","city":"Sample City","region":"Sample State","postal_code":"10001","country":"US"}
string
افتراضي:"11111111111"
مطلوب
رقم التعريف الضريبي أو المالي.مثال: 11111111111
string
افتراضي:"user-1234"
مرجعك الثابت للمستخدم، مثل معرّف المستخدم الداخلي لديك. يستخدمه Didit لربط الفحوصات المستقلة بالمستخدم النهائي نفسه، مما يقلل الضوضاء في اكتشاف التكرار.مثال: user-1234

قواعد الإدخال وملاحظات التحقق

  • رقم CPF البرازيلي (11 رقمًا بالضبط)
  • يجب أن يحتوي tax_number على أرقام فقط؛ أزل المسافات والشرطات وعلامات الترقيم قبل إرسال الطلب.
  • يجب أن يكون طول tax_number 11 حرفًا بالضبط.
  • بالنسبة إلى خدمات قواعد البيانات القائمة على العناوين، أرسل حقول العنوان المنظمة بدلًا من نص address واحد كلما أمكن ذلك.
  • يمثل address.street_1 عنوان الشارع، ويشمل رقم المبنى ونوع الشارع.
  • يمثل address.street_2 الشقة أو الوحدة أو المبنى أو الطابق أو أي سطر إضافي للعنوان. أرسله فقط عندما يكون متوفرًا لديك.
  • يمثل address.city المدينة أو الضاحية أو الحي أو المنطقة السكنية.
  • يمثل address.region الولاية أو المقاطعة أو الإقليم أو البلدة.
  • يمثل address.postal_code الرمز البريدي.
  • تتطلب خدمات قواعد البيانات القائمة على العناوين على الأقل عنوان الشارع والرمز البريدي؛ والطلبات المرفوضة قبل البحث في المصدر لا تُحتسب رسومها.

كيفية الاستدعاء

البيانات المُعادة

تعتمد الحقول الدقيقة التي تظهر في source_data على ما يُعيده السجل. يوثّق المثال المُولَّد للمسار bra_residential حالياً هذا الشكل الموحّد:
  • address
  • date_of_birth
  • first_name
  • identification_number
  • last_name

الأسعار واتفاقيات مستوى الخدمة

تُحتسب استعلامات السكني في البرازيل فقط عندما يتلقى Didit نتيجة حاسمة من مصدر التحقق.
  • سعر كل استدعاء: $0.59 USD.
  • الفوترة: لكل استعلام ناجح. لا تُحتسب رسوم عليك عندما يتعذّر الوصول إلى السجل، أو عندما تكون الحقول المطلوبة ناقصة، أو عندما يُرفض الطلب قبل وصوله إلى المصدر.
  • زمن الاستجابة: المئين 95 المعتاد أقل من 2 ثانية (p95 < 2 s).
  • التوفر: 99.9% في الربع الواحد من جهة Didit؛ ويختلف توفر المصادر التابعة حسب الدولة ومجموعة البيانات.

متابعة القراءة

آخر تعديل في ٧ نوفمبر ٢٠٢٦