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"
{
"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"
}
}
]
}
{
"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"
}
}
]
}
🇿🇦 ЮАР
Проверка владения автомобилем в ЮАР — API верификации
ЮАР — проверка владения автомобилем: запрос к официальной базе данных ЮАР через Didit. Оплата за вызов от $3.36, без контрактов и минимумов.
POST
/
v3
/
database-validation
/
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"
{
"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"
}
}
]
}
{
"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"
}
}
]
}
Подтверждает, что физическое лицо из ЮАР является зарегистрированным владельцем указанного транспортного средства по реестру транспортных средств NATIS. Didit предоставляет этот сервис через
POST /v3/database-validation/, чтобы вы могли сверить отправленные данные с авторитетным источником и получить нормализованные результаты сопоставления.
Охват
- Охват: —
- Страна: ЮАР
- ID сервиса:
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, или из значения, которое вы передаёте при создании сессии, и сопоставляйте каждое из них на шаге проверки по базам данных. Пока сопоставление не выполнено, редактор сценария показывает этот сервис как отключённый и называет отсутствующее входное значение. Во время выполнения отсутствие входного значения означает, что проверка пропускается до любого запроса, поэтому с вас не взимается плата за базу данных, которую невозможно запросить.
Параметры тела запроса
string
по умолчанию:"ZAF"
обязательно
Код страны по ISO 3166-1 alpha-3 для этого сервиса базы данных.Пример:
ZAFstring
по умолчанию:"zaf_vehicle_ownership"
обязательно
Массив, содержащий ID этого сервиса. Закрепление сервиса ограничивает запрос этой конкретной базой данных.Пример:
zaf_vehicle_ownershipstring
по умолчанию:"SAMPLE-NID-12345"
обязательно
Национальный идентификационный номер для этого сервиса.Пример:
SAMPLE-NID-12345string
по умолчанию:"VRN123456"
обязательно
Значение
vehicle_register_number, необходимое для этого сервиса базы данных.Пример: VRN123456string
по умолчанию:"ABC123GP"
обязательно
Значение
vehicle_licence_plate, необходимое для этого сервиса базы данных.Пример: ABC123GPstring
по умолчанию:"1HGCM82633A004352"
обязательно
Значение
vin, необходимое для этого сервиса базы данных.Пример: 1HGCM82633A004352string
по умолчанию:"user-1234"
Ваш стабильный идентификатор пользователя для этого человека, например внутренний ID пользователя. Didit использует его, чтобы связывать отдельные проверки с одним и тем же конечным пользователем и уменьшать количество ложных срабатываний при поиске дубликатов.Пример:
user-1234Правила для входных данных и примечания по валидации
- Отправляйте перечисленные выше поля точно так, как они получены от пользователя или из документа.
- Didit проверяет обязательные поля до обращения к базе данных. Запросы, отклонённые до обращения к источнику, не тарифицируются.
Как выполнить вызов
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 — это статус функции по умолчанию; ваши настроенные действия для частичного совпадения / отсутствия совпадения могут его изменить.MATCH — Реестр подтвердил личность, и все проверенные поля совпали.{
"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 — Реестр не вернул совпадений для отправленных данных.{
"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
Цены и SLA
Запросы проверки владения транспортным средством в ЮАР тарифицируются только тогда, когда Didit получает окончательный результат от источника валидации.- Цена за вызов: $3.36 USD.
- Биллинг: за успешный запрос. Плата не взимается, если реестр недоступен, если обязательные поля не заполнены или если запрос отклонён до обращения к источнику.
- Задержка: типичный p95 не превышает 2 с.
- Доступность: 99.9% за квартал со стороны Didit; доступность источника данных зависит от страны и набора данных.
Читайте далее
Последнее изменение 7 ноября 2026 г.