واجهة برمجة تطبيقات التحقق من الهوية الوطنية الماليزية (AR)

تتطلب عملية ضم المستخدمين في ماليزيا التأكد من هويتهم. تتحقق هذه الخدمة من بيانات الإدخال مقابل قاعدة بيانات وكالة حكومية تحتوي على بيانات المواطنين الماليزيين. يثبت المستند أو التفاصيل المكتوبة أن البيانات موجودة فقط — وليس أنها حقيقية أو تخص الشخص الذي أمامك. يغلق التحقق من الهوية الوطنية الماليزية هذه الفجوة عن طريق التحقق من البيانات مقابل السجل الحكومي الرسمي للهوية في البلاد. يشرح هذا الدليل ما تفعله عملية التحقق، والتفاصيل الفنية الدقيقة، وكيفية دمجها في دقائق.

النقاط الرئيسية:

• ماذا تتحقق منه — يتحقق التحقق من الهوية الوطنية الماليزية من الهوية الوطنية مقابل السجل الحكومي الرسمي للهوية في البلاد.
• ماذا تستعيد — match_type مُعَاير بالإضافة إلى نتائج على مستوى الحقل يمكنك توجيهها مباشرة إلى منطق الموافقة / المراجعة / الرفض.
• لماذا هو مهم — يمكن تزوير المستند؛ لا يمكن تزوير سجل السجل. التحقق من الهوية مقابل المصدر الحكومي الموثوق يؤكد أن صاحب الهوية حقيقي وتم تحديده بشكل صحيح.
• كيفية استخدامه — طلب POST واحد إلى نقطة نهاية التحقق من قاعدة بيانات Didit، أو وحدة سير عمل بدون تعليمات برمجية. 0.16 دولار لكل استعلام حاسم، والنتائج في ثوانٍ.

ماذا يتحقق منه التحقق من الهوية الوطنية الماليزية

تتحقق هذه الخدمة من بيانات الإدخال مقابل قاعدة بيانات وكالة حكومية تحتوي على بيانات المواطنين الماليزيين. تعرضها Didit من خلال نقطة نهاية واحدة حتى تتمكن من التحقق من البيانات المقدمة مقابل السجل الحكومي الرسمي للهوية في البلاد وتلقي نتيجة منظمة ومعايرة — وليس تفريغًا خامًا للسجل يجب عليك تحليله بنفسك.

تُرجع الاستجابة الحاسمة source_data المطابقة وكتلة validation لكل حقل، بحيث يحصل محرك المخاطر الخاص بك على حكم واضح ومقروء آليًا.

لماذا هو مهم

يمكن تزوير المستند؛ لا يمكن تزوير سجل السجل. التحقق من الهوية مقابل المصدر الحكومي الموثوق يؤكد أن صاحب الهوية حقيقي وتم تحديده بشكل صحيح.

بالنسبة للشركات المنظمة في ماليزيا — شركات التكنولوجيا المالية، ومنصات العملات المشفرة، والمقرضين، والأسواق، ومشغلي الألعاب — ينتج عن التحقق مقابل مصدر موثوق سجل قابل للدفاع والتدقيق يؤكد أن الهوية تم تأكيدها من المصدر، وليس مجرد التقاطها من نموذج أو صورة.

التفاصيل الفنية

تعرض Didit هذه الخدمة من خلال نقطة نهاية التحقق من قاعدة البيانات الموحدة. إنها عملية POST واحدة — لا يلزم وجود SDK.

نقطة النهاية

POST /v3/database-validation/

معلمات الطلب

المعلمة	النوع	مطلوب	الوصف
issuing_state	سلسلة نصية	نعم	رمز البلد ISO 3166-1 alpha-3. استخدم MYS.
services	سلسلة نصية	نعم	معرف الخدمة. استخدم mys_national_id.
full_name	سلسلة نصية	نعم	الاسم الكامل.
date_of_birth	سلسلة نصية	نعم	تاريخ الميلاد.
national_id	سلسلة نصية	نعم	الهوية الوطنية.
address	سلسلة نصية	لا	العنوان (تحقق إضافي اختياري).
phone	سلسلة نصية	لا	الهاتف (تحقق إضافي اختياري).

مثال على الطلب

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=MYS" \
  -F "services=mys_national_id" \
  -F "full_name=John Doe" \
  -F "date_of_birth=1990-01-01" \
  -F "national_id=1111111"

مثال على الاستجابة (مطابقة حاسمة)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "MYS",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "mys_national_id",
      "service_name": "Malaysia National ID",
      "source_data": {
        "address": "123 Sample Street",
        "address_match_score": "1.000",
        "city": "Sample City",
        "date_of_birth": "1990-01-01",
        "identification_number": "SAMPLE-ID-12345",
        "postal_code": "10001",
        "state": "Sample State",
        "street": "sample_value"
      },
      "validation": {
        "address": "full_match",
        "date_of_birth": "full_match",
        "identification_number": "full_match"
      }
    }
  ]
}

الأداء والفوترة

• الكمون: عادة بضع ثوانٍ.
• التكلفة: 0.16 دولار لكل استعلام حاسم. يتم فوترتك فقط على النتائج الحاسمة — لا توجد رسوم على تعطل المصدر، أو الحقول المفقودة، أو الرفض قبل المصدر.
• الموثوقية: يعمل على البنية التحتية لـ Didit مع هدف وقت تشغيل ربع سنوي بنسبة 99.9%.
• الموافقة: تتطلب هذه الخدمة موافقة المستخدم النهائي الموثقة. احصل عليها وخزنها قبل استدعاء نقطة النهاية.

حالات الاستخدام

• التكنولوجيا المالية والبنوك الرقمية — تأكيد وجود صاحب حساب حقيقي وقابل للتحقق قبل فتح محفظة أو تقديم ائتمان في ماليزيا.
• العملات المشفرة و Web3 — تلبية متطلبات ضم VASP بإثبات هوية من مصدر موثوق.
• الإقراض — تقليل الاحتيال بالهوية الاصطناعية والاحتيال من الطرف الأول ببيانات تم التحقق منها من المصدر.
• الأسواق ومنصات العمل الحر — التحقق من المستخدمين مقابل البيانات الموثوقة، وليس مجرد نموذج يتم الإبلاغ عنه ذاتيًا.
• الألعاب عبر الإنترنت — تلبية فحوصات الهوية والأهلية للاعبين الماليزيين بسجل تدقيق.

كيفية التكامل مع Didit

يمكنك تشغيل التحقق من الهوية الوطنية الماليزية بطريقتين:

1. سير عمل بدون تعليمات برمجية. في Didit Business Console، افتح Workflow Builder، أضف وحدة Database Validation، حدد Malaysia → Malaysia National ID Verification، وقم بتنشيطها. يتم توجيه المستخدمين المطابقين تلقائيًا — لا يلزم أي هندسة.
2. واجهة برمجة تطبيقات مباشرة. استدعاء نقطة النهاية /v3/database-validation/ الموضحة أعلاه باستخدام services=mys_national_id. اقرأ match_type وكتلة validation لكل حقل لتوجيه منطق الموافقة / المراجعة / الرفض الخاص بك.

يتضمن كل حساب Didit 500 عملية تحقق مجانية شهريًا، حتى تتمكن من اختبار التدفق الكامل من البداية إلى النهاية قبل الدفع مقابل استعلام واحد.

الأسئلة المتداولة

ماذا يؤكد التحقق من الهوية الوطنية الماليزية؟

يتحقق من البيانات المقدمة مقابل السجل الحكومي الرسمي للهوية في البلاد ويعيد نتيجة مطابقة معايرة، حتى تتعرف على ما إذا كانت الهوية الوطنية موجودة في المصدر الموثوق وأي الحقول تطابقت.

ماذا يحدث إذا كان المصدر غير متاح مؤقتًا؟

لا يتم محاسبتك. يتم تطبيق الفوترة فقط على النتائج الحاسمة — تعطل المصدر، والحقول المفقودة، والرفض قبل المصدر مجانية.

ما مدى سرعة التحقق؟

عادة ما تعود صلاحية قاعدة البيانات في بضع ثوانٍ، لذا فهي تتناسب مع تدفق الضم في الوقت الفعلي.

هل أحتاج إلى SDK؟

لا. التحقق هو طلب HTTPS POST واحد إلى نقطة نهاية واحدة. يمكنك أيضًا ربطه بسير عمل بدون تعليمات برمجية في Business Console.

هل أنت مستعد للبدء؟

تحقق من أول هوية وطنية ماليزية اليوم.

• اقرأ مرجع واجهة برمجة التطبيقات: التحقق من الهوية الوطنية الماليزية
• شاهد جميع عمليات التحقق من قاعدة البيانات: تسعير وتغطية التحقق من قاعدة البيانات
• ابدأ البناء: أنشئ حساب Didit مجانيًا — 500 عملية تحقق شهريًا، مجانًا.