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

التغطية

  • التغطية: > 80%
  • الدولة: سنغافورة
  • معرّف الخدمة: sgp_utility
  • نطاق البيانات: العنوان
  • الفئة: المرافق

المدخلات

  • الحقول المطلوبة: first_name، last_name، address.street_1، address.postal_code
  • الحقول الاختيارية: date_of_birth، phone، address.street_2، address.city، address.region، vendor_data
  • الموافقة: غير مطلوبة
  • إتاحة سير العمل: متاح في سير العمل
  • التغطية: > 80%
  • السعر: $2.82 لكل استعلام ناجح

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

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

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

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

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

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

تعتمد الحقول الدقيقة الظاهرة في source_data على ما يُرجعه السجل. يوثّق المثال المُولَّد لـ sgp_utility حاليًا هذا الشكل الموحّد:
  • address
  • address_match_score
  • city
  • date_of_birth
  • first_name
  • full_name
  • last_name
  • name_match_score
  • postal_code
  • street

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

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

مواصلة القراءة

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