الانتقال إلى المحتوى الرئيسي
POST
يتحقق من رخصة القيادة الأمريكية أو بطاقة الهوية الصادرة عن الولاية مقابل سجلات إدارة المركبات الآلية في الولاية المُصدِرة، ويؤكد رقم الرخصة وأسماء حاملها وتاريخ ميلاده. تتيح Didit هذه الخدمة عبر POST /v3/database-validation/ لتتمكن من التحقق من البيانات المُرسلة مقابل المصدر الرسمي المعتمد، والحصول على نتائج مطابقة موحّدة. تنسيق الإدخال: يقبل document_number رقم رخصة القيادة الأمريكية أو رقم بطاقة الهوية الصادرة عن الولاية (من 4-20 حرفاً ورقماً؛ يُسمح بالشرطات والمسافات).

التغطية

  • التغطية: ~ 90%
  • الدولة: الولايات المتحدة
  • معرّف الخدمة: usa_driver_license_dmv
  • نطاق البيانات: المستند
  • الفئة: رخصة القيادة

المدخلات

  • المدخلات المطلوبة: first_name، last_name، document_number، driver_license_state
  • المدخلات الاختيارية: middle_name، date_of_birth، date_of_issue، expiration_date، gender، document_type، vendor_data
  • الموافقة: غير مطلوبة
  • توفر سير العمل: متاح في سير العمل
  • التغطية: ~ 90%
  • السعر: ‏$1.99 لكل استعلام ناجح

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

string
افتراضي:"USA"
مطلوب
رمز الدولة ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.مثال: USA
string
افتراضي:"usa_driver_license_dmv"
مطلوب
مصفوفة تحتوي على معرّف هذه الخدمة. يؤدي تثبيت الخدمة إلى قصر الطلب على قاعدة البيانات المحددة هذه.مثال: usa_driver_license_dmv
string
افتراضي:"John"
مطلوب
الاسم الأول المراد التحقق منه.مثال: John
string
افتراضي:"Doe"
مطلوب
اسم العائلة المراد التحقق منه.مثال: Doe
string
افتراضي:"SAMPLE-DOC-12345"
مطلوب
رقم المستند المستخرج من المستند أو المقدَّم من المستخدم.مثال: SAMPLE-DOC-12345
string
افتراضي:"Sample State"
مطلوب
الولاية أو المنطقة التي أصدرت رخصة القيادة.مثال: Sample State
string
الاسم الأوسط، عند توفره.مثال: Demo
string
تاريخ الميلاد بتنسيق YYYY-MM-DD.مثال: 1990-01-01
string
قيمة date_of_issue التي تتطلبها خدمة قاعدة البيانات هذه.مثال: 1990-01-01
string
قيمة expiration_date التي تتطلبها خدمة قاعدة البيانات هذه.مثال: 1990-01-01
string
قيمة الجنس، عندما تتطلبها قاعدة البيانات.القيم المسموح بها: M (ذكر)، F (أنثى)، X (آخر أو غير معروف).مثال: M
string
نوع المستند المراد التحقق منه مقابل خدمة قاعدة البيانات هذه.القيم المسموح بها: DL (رخصة القيادة)، ID (الهوية الوطنية).مثال: DL
string
افتراضي:"user-1234"
مرجع المستخدم الثابت الخاص بك لهذا الشخص، مثل معرّف المستخدم الداخلي لديك. يستخدمه Didit لربط الفحوصات المستقلة بالمستخدم النهائي نفسه، وتقليل التشويش الناتج عن كشف التكرار.مثال: user-1234

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

  • رقم رخصة القيادة أو بطاقة الهوية الصادرة عن الولاية في الولايات المتحدة (من 4 إلى 20 محرفًا، تتكوّن من أحرف وأرقام؛ يُسمح بالشرطات والمسافات)
  • يجب أن يتراوح طول document_number بين 4 و20 محرفًا.
  • يجب أن يطابق document_number التعبير [A-Za-z0-9][A-Za-z0-9 -]{2,18}[A-Za-z0-9].
  • أرسل driver_license_state بوصفه الرمز المكوّن من حرفين للولاية المُصدِرة (TX) أو اسمها (Texas).
  • لا تتحقق هذه الخدمة من رخص القيادة الصادرة في كاليفورنيا وبنسلفانيا.

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

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

تعتمد الحقول الدقيقة التي تظهر في source_data على ما يُرجعه السجل. يوثّق المثال المُنشأ تلقائيًا لـ usa_driver_license_dmv حاليًا هذا الشكل الموحّد:
  • date_of_birth
  • first_name
  • identification_number
  • last_name
  • middle_name

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

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

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

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