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"
}
}
]
}
🇿🇦 África do Sul
Verificação de propriedade de veículo na África do Sul
Consulte a propriedade de veículos na África do Sul em base oficial via Didit. A partir de $3.36 por chamada, sem contratos nem mínimos.
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"
}
}
]
}
Confirma que uma pessoa sul-africana é a proprietária registrada de um determinado veículo por meio do registro de veículos NATIS. A Didit disponibiliza este serviço pelo
POST /v3/database-validation/, para que você verifique os dados enviados na fonte oficial e receba resultados de correspondência normalizados.
Cobertura
- Cobertura: —
- País: África do Sul
- ID do serviço:
zaf_vehicle_ownership - Domínio de dados: Governo
- Categoria: Outros
Entradas
| Campo | Obrigatório | Exemplo |
|---|---|---|
national_id | Sim | SAMPLE-NID-12345 |
vehicle_register_number | Sim | VRN123456 |
vehicle_licence_plate | Sim | ABC123GP |
vin | Sim | 1HGCM82633A004352 |
vendor_data | Não | user-1234 |
- Entradas obrigatórias:
national_id,vehicle_register_number,vehicle_licence_plate,vin - Entradas opcionais:
vendor_data - Consentimento: Não obrigatório
- Disponibilidade no fluxo: Disponível no fluxo de verificação (workflow) com mapeamento de campos
- Cobertura: —
- Preço: $3.36 por consulta bem-sucedida
vehicle_register_number, vehicle_licence_plate e vin não aparecem impressos em um documento de identidade, então nenhuma etapa os gera por conta própria. Colete esses valores em uma resposta ao Questionário, de um campo de extração do Document AI ou de um valor que você envia ao criar a sessão, e mapeie cada um deles na etapa de Validação de banco de dados. Enquanto não forem mapeados, o editor de fluxos mostra este serviço desativado e indica a entrada ausente; durante a execução, uma entrada ausente faz com que a verificação seja ignorada antes de qualquer consulta, então você nunca é cobrado por um banco de dados que não pôde ser consultado.
Parâmetros do corpo
string
padrão:"ZAF"
obrigatório
Código de país ISO 3166-1 alfa-3 deste serviço de banco de dados.Exemplo:
ZAFstring
padrão:"zaf_vehicle_ownership"
obrigatório
Array que contém este ID de serviço. Fixar o serviço mantém a requisição restrita a este banco de dados específico.Exemplo:
zaf_vehicle_ownershipstring
padrão:"SAMPLE-NID-12345"
obrigatório
Número de identidade nacional para este serviço.Exemplo:
SAMPLE-NID-12345string
padrão:"VRN123456"
obrigatório
Valor de
vehicle_register_number exigido por este serviço de banco de dados.Exemplo: VRN123456string
padrão:"ABC123GP"
obrigatório
Valor de
vehicle_licence_plate exigido por este serviço de banco de dados.Exemplo: ABC123GPstring
padrão:"1HGCM82633A004352"
obrigatório
Valor de
vin exigido por este serviço de banco de dados.Exemplo: 1HGCM82633A004352string
padrão:"user-1234"
Sua referência estável de usuário para esta pessoa, como o seu ID interno de usuário. A Didit a usa para vincular verificações avulsas ao mesmo usuário final e reduzir o ruído na detecção de duplicados.Exemplo:
user-1234Regras de entrada e notas de validação
- Envie os campos listados acima exatamente como foram capturados do usuário ou do documento.
- A Didit valida os campos obrigatórios antes de chamar o banco de dados. Requisições rejeitadas antes da consulta à fonte não são cobradas.
Como fazer a chamada
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"
Toda chamada bem-sucedida retorna HTTP 200. O campo outcome_code informa o que de fato aconteceu, distinguindo, por exemplo, uma divergência biométrica real (BIOMETRIC_NO_MATCH) de uma selfie que não pôde ser lida (BIOMETRIC_IMAGE_UNUSABLE). O status exibido é o status padrão do recurso; as ações de Partial Match / No Match que você configurou podem substituí-lo.MATCH: o registro confirmou a identidade e todos os campos verificados corresponderam.{
"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: o registro não retornou nenhuma correspondência para os dados enviados.{
"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"
}
}
]
}
Dados retornados
Os campos exatos exibidos emsource_data dependem dos dados retornados pelo registro. O exemplo gerado para zaf_vehicle_ownership documenta atualmente este formato normalizado:
identification_number
Preços e SLAs
As consultas de Verificação de propriedade de veículo na África do Sul são cobradas apenas quando a Didit recebe um resultado conclusivo da fonte de validação.- Preço por chamada: $3.36 USD.
- Faturamento: por consulta bem-sucedida. Você não é cobrado quando o registro está inacessível, quando faltam campos obrigatórios ou quando a requisição é rejeitada antes de chegar à fonte.
- Latência: p95 típico < 2 s.
- Disponibilidade: 99.9% por trimestre do lado da Didit; a disponibilidade da fonte externa varia conforme o país e o conjunto de dados.
Continue lendo
Última modificação em 1 de novembro de 2026