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

التغطية

  • التغطية: 100%*
  • الدولة: أستراليا
  • معرّف الخدمة: aus_electoral_roll
  • نطاق البيانات: حكومي
  • الفئة: ElectoralRoll

المدخلات

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

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

string
افتراضي:"AUS"
مطلوب
رمز الدولة وفق ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.مثال: AUS
string
افتراضي:"aus_electoral_roll"
مطلوب
مصفوفة تحتوي على معرّف هذه الخدمة. تثبيت الخدمة يُبقي الطلب مقصوراً على قاعدة البيانات المحددة هذه تحديداً.مثال: aus_electoral_roll
موافقة المستخدم النهائي الصريحة على هذه الخدمة.مثال: 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.street_1 هو عنوان الشارع، ويشمل رقم المبنى ونوع الشارع.
  • address.street_2 هو الشقة أو الوحدة أو المبنى أو الطابق أو أي سطر إضافي للعنوان. أرسله فقط عندما تتوفر لديك هذه البيانات.
  • address.city هو المدينة أو الضاحية أو المنطقة أو الحي أو الجوار.
  • address.region هو الولاية أو المحافظة أو الإقليم أو البلدة.
  • address.postal_code هو الرمز البريدي.
  • تتطلب خدمات قواعد البيانات القائمة على العناوين على الأقل عنوان الشارع والرمز البريدي. والطلبات المرفوضة قبل البحث في المصدر لا تُحتسب.

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

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

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

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

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

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

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