> ## 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. الدفع لكل استدعاء بدءاً من $3.36، بلا عقود ولا حد أدنى.

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

## التغطية

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

## المدخلات

| الحقل | مطلوب | مثال |
| - | -: | - |
| `national_id` | نعم | `SAMPLE-NID-12345` |
| `vehicle_register_number` | نعم | `VRN123456` |
| `vehicle_licence_plate` | نعم | `ABC123GP` |
| `vin` | نعم | `1HGCM82633A004352` |
| `vendor_data` | لا | `user-1234` |

* **المدخلات المطلوبة:** `national_id`، و`vehicle_register_number`، و`vehicle_licence_plate`، و`vin`
* **المدخلات الاختيارية:** `vendor_data`
* **الموافقة:** غير مطلوبة
* **توفر سير العمل:** متاح في سير العمل مع ربط الحقول
* **التغطية:** —
* **السعر:** \$3.36 لكل استعلام ناجح

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

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

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

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

مثال: `ZAF`

**services** `string` *required* (default: zaf\_vehicle\_ownership)

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

مثال: `zaf_vehicle_ownership`

**national\_id** `string` *required* (default: SAMPLE-NID-12345)

رقم الهوية الوطنية لهذه الخدمة.

مثال: `SAMPLE-NID-12345`

**vehicle\_register\_number** `string` *required* (default: VRN123456)

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

مثال: `VRN123456`

**vehicle\_licence\_plate** `string` *required* (default: ABC123GP)

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

مثال: `ABC123GP`

**vin** `string` *required* (default: 1HGCM82633A004352)

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

مثال: `1HGCM82633A004352`

**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_vehicle_ownership" \
  -F "vendor_data=user-1234" \
  -F "national_id=SAMPLE-NID-12345" \
  -F "vehicle_register_number=VRN123456" \
  -F "vehicle_licence_plate=ABC123GP" \
  -F "vin=1HGCM82633A004352"
```

تُرجع كل عملية استدعاء ناجحة الرمز 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_vehicle_ownership",
      "service_name": "South Africa - Vehicle Ownership Verification",
      "source_data": {
        "identification_number": "SAMPLE-ID-12345"
      },
      "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_vehicle_ownership",
      "service_name": "South Africa - Vehicle Ownership Verification",
      "source_data": {
        "identification_number": "NO_MATCH"
      },
      "validation": {
        "identification_number": "no_match"
      }
    }
  ]
}
```

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

تعتمد الحقول الدقيقة المعروضة في `source_data` على ما يُرجعه السجل. يوثّق المثال المُنشأ لـ `zaf_vehicle_ownership` حاليًا هذا الشكل الموحّد:

* `identification_number`

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

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

* **السعر لكل استعلام:** \$3.36 USD.
* **الفوترة:** لكل استعلام ناجح. لا تُحتسب عليك تكلفة عندما يكون السجل غير قابل للوصول، أو عندما تكون الحقول المطلوبة مفقودة، أو عندما يُرفض الطلب قبل وصوله إلى المصدر.
* **زمن الاستجابة:** قيمة p95 المعتادة أقل من ثانيتين.
* **التوفر:** 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.