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

التغطية

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

المدخلات

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

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

string
افتراضي:"IND"
مطلوب
رمز الدولة وفق ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.مثال: IND
string
افتراضي:"ind_aadhaar"
مطلوب
مصفوفة تحتوي على معرّف هذه الخدمة. تثبيت الخدمة يُبقي الطلب مقصورًا على قاعدة البيانات هذه بالتحديد.مثال: ind_aadhaar
موافقة صريحة من المستخدم النهائي على هذه الخدمة.مثال: true
string
افتراضي:"John Doe"
مطلوب
الاسم القانوني الكامل المراد التحقق منه.مثال: John Doe
string
افتراضي:"1990-01-01"
مطلوب
تاريخ الميلاد بصيغة YYYY-MM-DD.مثال: 1990-01-01
string
افتراضي:"111111111111"
مطلوب
رقم الهوية الشخصية الخاص بالدولة.مثال: 111111111111
string
افتراضي:"ABCDE1234F"
مطلوب
رقم الحساب الدائم (Permanent Account Number).مثال: ABCDE1234F
string
افتراضي:"user-1234"
معرّفك الثابت لهذا الشخص، مثل معرّف المستخدم الداخلي لديك. يستخدمه Didit لربط عمليات التحقق المستقلة بالمستخدم النهائي نفسه، وتقليل ضجيج اكتشاف التكرار.مثال: user-1234

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

  • يجب أن يستخدم pan حروفًا كبيرة.
  • يجب أن يطابق pan النمط [A-Z]{5}\d{4}[A-Z].
  • يجب أن يحتوي personal_number على أرقام فقط؛ أزل المسافات والشرطات وعلامات الترقيم قبل إرسال الطلب.
  • يجب أن يكون طول personal_number 12 حرفًا بالضبط.

كيفية استدعائها

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

تعتمد الحقول الدقيقة المعروضة في source_data على ما يُرجعه السجل. يوثّق المثال المُولَّد لـ ind_aadhaar حاليًا هذا الشكل الموحّد:
  • date_of_birth
  • full_name
  • identification_number

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

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

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

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