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

التغطية

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

المدخلات

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

معاملات نص الطلب

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

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

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

طريقة الاستدعاء

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

تعتمد الحقول الدقيقة المعروضة في source_data على ما يُرجعه السجل. يوثّق المثال المُنشأ تلقائياً لـ phl_residential حالياً بنية الحقول الموحّدة التالية:
  • date_of_birth
  • name_match_score

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

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

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

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