الانتقال إلى المحتوى الرئيسي
POST
يتحقق من بيانات الإدخال مقابل بيانات رقم الهوية الوطنية المستمدة من جهة حكومية. تتيح Didit هذه الخدمة عبر POST /v3/database-validation/ حتى تتمكن من التحقق من البيانات المُرسلة مقابل المصدر الموثوق، واستلام نتائج مطابقة موحّدة. تنسيق الإدخال: يقبل national_id رقم الهوية الوطنية التايلاندية، وهو 13 رقمًا يكون آخرها رقم التحقق mod-11 (بأوزان من 13 إلى 2 على الأرقام الاثني عشر الأولى).

التغطية

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

المدخلات

  • الحقول المطلوبة: first_name وlast_name وdate_of_birth وnational_id
  • الحقول الاختيارية: address.street_1 وaddress.street_2 وaddress.city وaddress.region وaddress.postal_code وvendor_data
  • الموافقة: مطلوبة
  • توفر سير العمل: متاح في سير العمل
  • التغطية: ~ 90%
  • السعر: $0.59 لكل استعلام ناجح

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

string
افتراضي:"THA"
مطلوب
رمز الدولة ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.مثال: THA
string
افتراضي:"tha_national_id"
مطلوب
مصفوفة تحتوي على معرّف هذه الخدمة. تثبيت الخدمة يُبقي الطلب مقصورًا على قاعدة البيانات المحددة هذه.مثال: tha_national_id
موافقة صريحة من المستخدم النهائي على هذه الخدمة.مثال: true
string
افتراضي:"John"
مطلوب
الاسم الأول المراد التحقق منه.مثال: John
string
افتراضي:"Doe"
مطلوب
اسم العائلة المراد التحقق منه.مثال: Doe
string
افتراضي:"1990-01-01"
مطلوب
تاريخ الميلاد بتنسيق YYYY-MM-DD.مثال: 1990-01-01
string
افتراضي:"1111111111111"
مطلوب
رقم الهوية الوطنية لهذه الخدمة.مثال: 1111111111111
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 بتقسيمها إلى عناصر عنوان منظّمة عند الإمكان، أو يمكنك إرسال الحقول المنظّمة بشكل صريح.
  • رقم الهوية الوطنية التايلاندية: 13 رقمًا يكون آخرها رقم التحقق mod-11 (بأوزان من 13 إلى 2 على الأرقام الاثني عشر الأولى).
  • يجب أن يحتوي national_id على أرقام فقط؛ أزل المسافات والشرطات وعلامات الترقيم قبل إرسال الطلب.
  • يجب أن يكون طول national_id 13 حرفًا بالضبط.
  • يُتحقق من رقم التحقق الأخير في الرقم الوطني التايلاندي (mod 11)؛ يُرفض الرقم الذي يفشل في هذا الفحص قبل البحث، ولا تُحتسب عليه رسوم.
  • بالنسبة لخدمات العناوين، أرسل حقول العنوان المنظّمة بدلًا من سلسلة address واحدة متى أمكن ذلك.
  • address.street_1 هو عنوان الشارع، ويشمل رقم المبنى ونوع الشارع.
  • address.street_2 هو الشقة أو الوحدة أو المبنى أو الطابق أو أي سطر عنوان إضافي. أرسله فقط عند توفره لديك.
  • address.city هو المدينة أو الضاحية أو المنطقة أو البلدة أو الحي.
  • address.region هو الولاية أو المحافظة أو الإقليم أو البلدة.
  • address.postal_code هو الرمز البريدي.
  • تتطلب خدمات قواعد البيانات القائمة على العناوين عنوان الشارع والرمز البريدي على الأقل؛ ولا تُحتسب رسوم على الطلبات المرفوضة قبل البحث في المصدر.

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

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

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

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

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

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

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