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

التغطية

  • التغطية: -
  • الدولة: جنوب أفريقيا
  • معرّف الخدمة: zaf_company_registry
  • نطاق البيانات: الحكومة
  • الفئة: CompanyRegister

المدخلات

  • المدخلات المطلوبة: company_registration_number
  • المدخلات الاختيارية: company_name، vendor_data
  • الموافقة: غير مطلوبة
  • توفر سير العمل: متاح في سير العمل مع ربط الحقول
  • التغطية: -
  • السعر: $0.75 لكل استعلام ناجح
في سير العمل، لا يُطبع company_registration_number على أي مستند هوية، لذلك لا توجد خطوة تنتجه بمفردها. اجمعه من إجابة في الاستبيان، أو من حقل مستخرج عبر Document AI، أو من قيمة ترسلها عند إنشاء الجلسة، ثم اربطه في خطوة التحقق من قواعد البيانات. وإلى أن يتم ربطه، يعرض محرر سير العمل هذه الخدمة معطّلة ويسمّي المدخل الناقص. وأثناء التشغيل، يعني المدخل الناقص أن الفحص يُتخطّى قبل أي استعلام، فلا تُحتسب عليك تكلفة قاعدة بيانات لم يكن بالإمكان الاستعلام منها.

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

string
افتراضي:"ZAF"
مطلوب
رمز الدولة ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.مثال: ZAF
string
افتراضي:"zaf_company_registry"
مطلوب
مصفوفة تحتوي على معرّف هذه الخدمة. تثبيت الخدمة يُبقي الطلب مقصورًا على قاعدة البيانات المحددة هذه بالذات.مثال: zaf_company_registry
string
افتراضي:"REG-123456"
مطلوب
القيمة company_registration_number مطلوبة من قبل خدمة قاعدة البيانات هذه.مثال: REG-123456
string
القيمة company_name مطلوبة من قبل خدمة قاعدة البيانات هذه.مثال: Sample Company LLC
string
افتراضي:"user-1234"
المرجع الثابت للمستخدم لدى نظامك لهذا الشخص، مثل معرّف المستخدم الداخلي لديك. تستخدمه Didit لربط الفحوصات المستقلة بالمستخدم النهائي نفسه، وتقليل الضوضاء في كشف التكرار.مثال: user-1234

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

  • أرسل الحقول المذكورة أعلاه كما هي تمامًا كما أُدخلت من المستخدم أو من المستند.
  • تتحقق Didit من الحقول المطلوبة قبل استدعاء قاعدة البيانات. الطلبات التي تُرفض قبل الوصول إلى المصدر لا تُحتسب تكلفتها.

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

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

تعتمد الحقول الدقيقة الظاهرة في source_data على ما يعيده السجل. يوثّق المثال المُولَّد لـ zaf_company_registry حاليًا بنية الاستجابة الموحدة التالية:
  • يختلف حسب استجابة السجل.

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

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

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

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