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

التغطية

  • التغطية: > 75%
  • الدولة: ماليزيا
  • معرّف الخدمة: mys_national_id
  • نطاق البيانات: الهوية
  • الفئة: NationalIDRegistry

المدخلات

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

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

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

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

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

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

البيانات المُرجعة

تعتمد الحقول الدقيقة الظاهرة في source_data على ما يُرجعه السجل. يوثّق المثال المُولّد لـ mys_national_id حالياً هذا الشكل الموحّد:
  • address
  • address_match_score
  • city
  • date_of_birth
  • identification_number
  • postal_code
  • state
  • street

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

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

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

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