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

التغطية

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

المدخلات

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

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

string
افتراضي:"IDN"
مطلوب
رمز الدولة وفق ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.مثال: IDN
string
افتراضي:"idn_residential_identity_card"
مطلوب
مصفوفة تحتوي على معرّف هذه الخدمة. تثبيت الخدمة يُبقي الطلب مقتصراً على قاعدة البيانات المحددة هذه تحديداً.مثال: idn_residential_identity_card
موافقة صريحة من المستخدم النهائي على هذه الخدمة.مثال: true
string
افتراضي:"John Doe"
مطلوب
الاسم القانوني الكامل المراد التحقق منه.مثال: John Doe
string
افتراضي:"1990-01-01"
مطلوب
تاريخ الميلاد بصيغة YYYY-MM-DD.مثال: 1990-01-01
string
افتراضي:"1111111111111111"
مطلوب
رقم الهوية الوطنية لهذه الخدمة.مثال: 1111111111111111
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
قيمة الجنس، عندما تشترطها قاعدة البيانات.القيم المسموحة: M (ذكر)، F (أنثى)، X (آخر أو غير معروف).مثال: M
string
افتراضي:"user-1234"
مرجعك الثابت لهذا الشخص، مثل معرّف المستخدم الداخلي لديك. يستخدمه Didit لربط الفحوص المستقلة بالمستخدم النهائي نفسه، وتقليل ضجيج اكتشاف التكرار.مثال: user-1234

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

  • يجب أن يحتوي national_id على أرقام فقط؛ أزل المسافات والشرطات وعلامات الترقيم قبل إرسال الطلب.
  • يجب أن يكون طول national_id 16 حرفاً بالضبط.
  • بالنسبة إلى خدمات العناوين، أرسل حقول العنوان المُهيكلة بدلاً من سلسلة address واحدة كلما أمكن.
  • address.street_1 هو عنوان الشارع، ويشمل رقم المبنى ونوع الشارع.
  • address.street_2 هو الشقة أو الوحدة أو المبنى أو الطابق أو أي سطر إضافي للعنوان. أرسله فقط عندما تتوفر لديك هذه البيانات.
  • address.city هو المدينة أو الضاحية أو المنطقة أو البلدة أو الحي.
  • address.region هو الولاية أو المحافظة أو الإقليم أو البلدة.
  • address.postal_code هو الرمز البريدي.
  • تتطلب خدمات قواعد البيانات القائمة على العناوين عنوان الشارع والرمز البريدي على الأقل؛ والطلبات المرفوضة قبل الاستعلام عن المصدر لا يتم احتساب رسوم عليها.

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

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

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

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

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

تابع القراءة

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