الانتقال إلى المحتوى الرئيسي
POST
يتحقق من بيانات الإدخال مقابل قاعدة بيانات تابعة لجهة حكومية تتضمن بيانات الهوية الوطنية للمواطنين. تتيح Didit هذه الخدمة عبر POST /v3/database-validation/ لتتمكن من التحقق من البيانات المرسلة مقابل المصدر الموثوق والحصول على نتائج مطابقة موحدة.

التغطية

  • التغطية: ~ 80%
  • الدولة: كمبوديا
  • معرّف الخدمة: khm_national_id
  • نطاق البيانات: الهوية
  • الفئة: NationalIDRegistry

المدخلات

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

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

string
افتراضي:"KHM"
مطلوب
رمز الدولة وفق ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.مثال: KHM
string
افتراضي:"khm_national_id"
مطلوب
مصفوفة تحتوي على معرّف هذه الخدمة. يُبقي تثبيت الخدمة الطلب مقصورًا على قاعدة البيانات هذه تحديدًا.مثال: khm_national_id
موافقة صريحة من المستخدم النهائي على هذه الخدمة.مثال: true
string
افتراضي:"John"
مطلوب
الاسم الأول المراد التحقق منه.مثال: John
string
افتراضي:"Doe"
مطلوب
اسم العائلة المراد التحقق منه.مثال: Doe
string
افتراضي:"1990-01-01"
مطلوب
تاريخ الميلاد بصيغة YYYY-MM-DD.مثال: 1990-01-01
string
افتراضي:"12345678"
مطلوب
معرّف الناخب.مثال: 12345678
string
قيمة الجنس، عندما تشترطها قاعدة البيانات.القيم المسموحة: M (ذكر)، F (أنثى)، X (آخر أو غير معروف).مثال: M
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
افتراضي:"user-1234"
مرجعك الثابت للمستخدم، مثل معرّف المستخدم الداخلي لديك. تستخدمه Didit لربط الفحوص المستقلة بالمستخدم النهائي نفسه وتقليل الضجيج الناتج عن كشف التكرار.مثال: user-1234

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

  • الحقل address اختياري لهذه الخدمة. يمكنك إرسال عنوان address واحد كامل، وستقوم Didit بتقسيمه إلى عناصر عنوان منظمة عندما يكون ذلك ممكنًا، أو يمكنك إرسال الحقول المنظمة بشكل صريح.
  • يجب أن يطابق voter_id التعبير (?:\d{8,9}|\d{2}-\d{3}-\d{3}).
  • بالنسبة لخدمات العناوين، أرسل حقول العنوان المنظمة بدلًا من سلسلة address واحدة كلما أمكن ذلك.
  • address.street_1 هو عنوان الشارع، ويشمل رقم المبنى ونوع الشارع.
  • address.street_2 هو الشقة أو الوحدة أو المبنى أو الطابق أو أي سطر إضافي للعنوان. أرسله فقط عندما يتوفر لديك.
  • address.city هو المدينة أو الضاحية أو الحي أو المنطقة السكنية.
  • address.region هو الولاية أو المحافظة أو المنطقة أو البلدة.
  • address.postal_code هو الرمز البريدي.
  • تتطلب خدمات قواعد البيانات المعتمدة على العنوان على الأقل عنوان الشارع والرمز البريدي؛ ولا تُفرض عليك رسوم على الطلبات المرفوضة قبل البحث في المصدر.

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

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

تعتمد الحقول الدقيقة التي تظهر في source_data على ما يُرجعه السجل. يوثّق المثال المُولَّد تلقائياً لـkhm_national_id حالياً هذا الشكل الموحّد:
  • address
  • address_match_score
  • building_number
  • city
  • date_of_birth
  • first_name
  • full_name
  • identification_number
  • last_name
  • name_match_score
  • state
  • street

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

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

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

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