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

التغطية

  • التغطية: ~ 50%
  • الدولة: أستراليا
  • معرّف الخدمة: aus_superannuation_payroll
  • نطاق البيانات: مالي
  • الفئة: التقاعد

المدخلات

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

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

string
افتراضي:"AUS"
مطلوب
رمز الدولة وفق ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.مثال: AUS
string
افتراضي:"aus_superannuation_payroll"
مطلوب
مصفوفة تحتوي على معرّف هذه الخدمة. تثبيت الخدمة يُبقي الطلب مقتصراً على قاعدة البيانات المحددة هذه.مثال: aus_superannuation_payroll
موافقة صريحة من المستخدم النهائي على هذه الخدمة.مثال: 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 على ما يُرجعه السجل. يوثّق المثال المُولَّد لـ aus_superannuation_payroll حالياً هذا الشكل الموحّد:
  • address
  • date_of_birth
  • first_name
  • last_name

Pricing & SLAs

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

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

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