> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# التحقق من سجل الشركات في جنوب أفريقيا - واجهة API

> استعلام سجل الشركات في جنوب أفريقيا عبر Didit من قاعدة بيانات موثوقة. الدفع لكل استدعاء بدءاً من $0.75، بلا عقود ولا حد أدنى.

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

## التغطية

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

## المدخلات

| الحقل | مطلوب | مثال |
| - | -: | - |
| `company_registration_number` | نعم | `REG-123456` |
| `company_name` | لا | `Sample Company LLC` |
| `vendor_data` | لا | `user-1234` |

* **المدخلات المطلوبة:** `company_registration_number`
* **المدخلات الاختيارية:** `company_name`، `vendor_data`
* **الموافقة:** غير مطلوبة
* **توفر سير العمل:** متاح في سير العمل مع ربط الحقول
* **التغطية:** -
* **السعر:** \$0.75 لكل استعلام ناجح

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

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

**issuing\_state** `string` *required* (default: ZAF)

رمز الدولة ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.

مثال: `ZAF`

**services** `string` *required* (default: zaf\_company\_registry)

مصفوفة تحتوي على معرّف هذه الخدمة. تثبيت الخدمة يُبقي الطلب مقصورًا على قاعدة البيانات المحددة هذه بالذات.

مثال: `zaf_company_registry`

**company\_registration\_number** `string` *required* (default: REG-123456)

القيمة `company_registration_number` مطلوبة من قبل خدمة قاعدة البيانات هذه.

مثال: `REG-123456`

**company\_name** `string`

القيمة `company_name` مطلوبة من قبل خدمة قاعدة البيانات هذه.

مثال: `Sample Company LLC`

**vendor\_data** `string` (default: user-1234)

المرجع الثابت للمستخدم لدى نظامك لهذا الشخص، مثل معرّف المستخدم الداخلي لديك. تستخدمه Didit لربط الفحوصات المستقلة بالمستخدم النهائي نفسه، وتقليل الضوضاء في كشف التكرار.

مثال: `user-1234`

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

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

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

```bash cURL theme={null}
curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=ZAF" \
  -F "services=zaf_company_registry" \
  -F "vendor_data=user-1234" \
  -F "company_registration_number=REG-123456"
```

تُرجع كل عملية استدعاء ناجحة رمز الحالة HTTP `200`. يوضح الحقل **`outcome_code`** ما حدث فعليًا، فيميّز مثلًا بين عدم تطابق بيومتري حقيقي (`BIOMETRIC_NO_MATCH`) وصورة سيلفي تعذّرت قراءتها (`BIOMETRIC_IMAGE_UNUSABLE`). الحالة `status` المعروضة هي الحالة الافتراضية للميزة، ويمكن أن تتجاوزها [إجراءات التطابق الجزئي / عدم التطابق](https://docs.didit.me/ar/core-technology/database-validation/database-validation-warnings.md) التي تضبطها لديك.

**`MATCH`** - أكّد السجل الهوية، وتطابق كل حقل جرى التحقق منه.

```json 200 OK — MATCH theme={null}
{
  "request_id": "req_01H…",
  "status": "Approved",
  "issuing_state": "ZAF",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "zaf_company_registry",
      "service_name": "South Africa - Company Registry Lookup",
      "source_data": {},
      "validation": {
        "identification_number": "full_match"
      }
    }
  ]
}
```

**`NO_MATCH`** - لم يُرجع السجل أي تطابق للبيانات المُرسلة.

```json 200 OK — NO_MATCH theme={null}
{
  "request_id": "req_01H…",
  "status": "Declined",
  "issuing_state": "ZAF",
  "match_type": "no_match",
  "validations": [
    {
      "outcome_code": "NO_MATCH",
      "service_id": "zaf_company_registry",
      "service_name": "South Africa - Company Registry Lookup",
      "source_data": {
        "identification_number": "NO_MATCH"
      },
      "validation": {
        "identification_number": "no_match"
      }
    }
  ]
}
```

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

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

* يختلف حسب استجابة السجل.

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

استعلامات البحث في سجل الشركات في جنوب أفريقيا لا تُحتسب إلا عندما تتلقى Didit نتيجة حاسمة من مصدر التحقق.

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

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

* [نظرة عامة على التحقق من قواعد البيانات في جنوب أفريقيا](https://docs.didit.me/api-reference/database-validation/south-africa.md)
* [نظرة عامة على التحقق من قواعد البيانات](https://docs.didit.me/ar/core-technology/database-validation/overview.md)
* [رموز النتائج](https://docs.didit.me/ar/core-technology/database-validation/database-validation-outcome-codes.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.