الانتقال إلى المحتوى الرئيسي
POST
يتحقق من بيانات الإدخال مقابل خدمة البيانات الرسمية في الصين. تتيح لك Didit هذه الخدمة عبر POST /v3/database-validation/ لتتمكن من التحقق من البيانات المُرسلة مقابل المصدر الموثوق، والحصول على نتائج تطابق موحّدة. تنسيق الإدخال: يأخذ date_of_birth القيمة التي يجب أن تطابق تاريخ الميلاد المرمّز في الهوية الوطنية الصينية (الأرقام من 7 إلى 14 في رقم مكوّن من 18 خانة، ومن 7 إلى 12 في الرقم القديم المكوّن من 15 رقماً).

التغطية

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

المدخلات

  • المدخلات المطلوبة: full_name، date_of_birth، national_id
  • المدخلات الاختيارية: vendor_data
  • الموافقة: مطلوبة
  • توفر سير العمل: متاح في سير العمل
  • التغطية: ~ 100%
  • السعر: $0.50 لكل استعلام ناجح
ليست كل المستندات التي تقبلها هذه الخدمة تحمل المعرّف الذي تستعلم به. عندما لا يُستخرج المعرّف من المستند، يُسجَّل الفحص على أنه غير قابل للتطبيق: لا يُستعلم من أي قاعدة بيانات ولا تُحتسب أي رسوم، وهو ما يمثل نسبة كبيرة من المستخدمين الفعليين في بعض الدول. لتغطيتهم، اجمع المعرّف أيضاً من إجابة في الاستبيانات، أو من حقل استخراج في Document AI، أو من قيمة ترسلها عند إنشاء الجلسة، ثم اربطه بخطوة التحقق من قواعد البيانات.

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

string
افتراضي:"CHN"
مطلوب
رمز الدولة وفق ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.مثال: CHN
string
افتراضي:"chn_national_id"
مطلوب
مصفوفة تحتوي على معرّف هذه الخدمة. تثبيت الخدمة يُبقي الطلب مقتصراً على قاعدة البيانات المحددة هذه.مثال: chn_national_id
موافقة صريحة من المستخدم النهائي على هذه الخدمة.مثال: true
string
افتراضي:"王新伟"
مطلوب
الاسم القانوني الكامل المراد التحقق منه.مثال: 王新伟
string
افتراضي:"1990-01-01"
مطلوب
تاريخ الميلاد بتنسيق YYYY-MM-DD.مثال: 1990-01-01
string
افتراضي:"11010519900101003X"
مطلوب
رقم الهوية الوطنية لهذه الخدمة.مثال: 11010519900101003X
string
افتراضي:"user-1234"
مرجعك الثابت لهذا الشخص، مثل معرّف المستخدم الداخلي لديك. تستخدمه Didit لربط الفحوصات المستقلة بالمستخدم النهائي نفسه، وتقليل الضوضاء في اكتشاف التكرار.مثال: user-1234

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

  • يجب أن يطابق تاريخ الميلاد تاريخ الميلاد المرمّز في الهوية الوطنية الصينية (الأرقام من 7 إلى 14 في رقم مكوّن من 18 خانة، ومن 7 إلى 12 في الرقم القديم المكوّن من 15 رقماً)
  • يجب أن يطابق date_of_birth تاريخ الميلاد المرمّز في national_id؛ يرفض المصدر الطلب مباشرةً عندما لا يتطابق الاثنان، لذا يُرفض عدم التطابق قبل الاستعلام ولا يُحتسب.
  • يجب أن يطابق national_id التعبير (\d{15}|\d{17}[\dXx]).
  • يتم التحقق من خانة التحقق الأخيرة في بطاقة هوية المقيم الصينية.
  • يجب أن يكون full_name بالاسم الأصلي بالحروف الصينية كما يظهر في السجل أو في المستند. لا ترسل النسخة اللاتينية المكتوبة صوتياً في فحوصات قواعد البيانات الصينية.

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

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

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

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

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

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

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