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ículos - África do Sul
Verifique a propriedade de veículos na África do Sul com consulta a base de dados oficial via Didit. Desde $3.36 por chamada, sem contratos.
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 um particular sul-africano é o proprietário registado de um determinado veículo através do registo de veículos NATIS. A Didit disponibiliza este serviço através de
POST /v3/database-validation/, para que possa validar os dados submetidos face à fonte oficial e receber resultados de correspondência normalizados.
Cobertura
- Cobertura: —
- País: África do Sul
- ID do serviço:
zaf_vehicle_ownership - Domínio de dados: Administração pública
- Categoria: Outra
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 é necessário
- Disponibilidade no fluxo: disponível no fluxo com mapeamento de campos
- Cobertura: —
- Preço: $3.36 por consulta bem-sucedida
vehicle_register_number, vehicle_licence_plate e vin não são impressos num documento de identidade, pelo que nenhum passo os produz por si só. Recolha-os a partir de uma resposta de um Questionário, de um campo extraído pelo Document AI ou de um valor que envie ao criar a sessão, e mapeie cada um no passo Validação de base de dados. Enquanto não forem mapeados, o editor de fluxos mostra este serviço desativado e indica a entrada em falta. Em tempo de execução, uma entrada em falta significa que a verificação é ignorada antes de qualquer consulta, pelo que nunca lhe é cobrado qualquer valor por uma base de dados que não pôde ser consultada.
Parâmetros do corpo
string
padrão:"ZAF"
obrigatório
Código de país ISO 3166-1 alpha-3 para este serviço de base 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 o pedido limitado a esta base de dados exata.Exemplo:
zaf_vehicle_ownershipstring
padrão:"SAMPLE-NID-12345"
obrigatório
Número de identificação 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 base de dados.Exemplo: VRN123456string
padrão:"ABC123GP"
obrigatório
Valor de
vehicle_licence_plate exigido por este serviço de base de dados.Exemplo: ABC123GPstring
padrão:"1HGCM82633A004352"
obrigatório
Valor de
vin exigido por este serviço de base de dados.Exemplo: 1HGCM82633A004352string
padrão:"user-1234"
A sua referência estável de utilizador para esta pessoa, como o seu ID interno de utilizador. A Didit usa-a para ligar verificações independentes ao mesmo utilizador final e reduzir o ruído na deteção de duplicados.Exemplo:
user-1234Regras de entrada e notas de validação
- Envie os campos indicados acima exatamente como foram recolhidos do utilizador ou do documento.
- A Didit valida os campos obrigatórios antes de chamar a base de dados. Os pedidos rejeitados antes da consulta à fonte não são cobrados.
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"
Cada chamada bem-sucedida devolve HTTP 200. O campo outcome_code indica o que aconteceu de facto, distinguindo, por exemplo, uma incompatibilidade biométrica real (BIOMETRIC_NO_MATCH) de uma selfie que não pôde ser lida (BIOMETRIC_IMAGE_UNUSABLE). O status apresentado é o estado predefinido da funcionalidade; as suas ações de Correspondência parcial / Sem correspondência configuradas podem substituí-lo.MATCH: o registo confirmou a identidade e todos os campos verificados correspondiam.{
"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 registo não devolveu qualquer correspondência para os dados submetidos.{
"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 devolvidos
Os campos exatos apresentados emsource_data dependem do que o registo devolver. O exemplo gerado para zaf_vehicle_ownership documenta atualmente esta estrutura normalizada:
identification_number
Preços e SLAs
As consultas de Verificação de propriedade de veículos na África do Sul só são faturadas quando a Didit recebe um resultado conclusivo da fonte de validação.- Preço por chamada: $3.36 USD.
- Faturação: por consulta bem-sucedida. Não lhe é cobrado qualquer valor quando o registo está inacessível, quando faltam campos obrigatórios ou quando o pedido é rejeitado antes de chegar à fonte.
- Latência: p95 típico < 2 s.
- Disponibilidade: 99.9% por trimestre do lado da Didit; a disponibilidade da fonte a jusante varia consoante o país e o conjunto de dados.
Continuar a ler
Última modificação em 7 de novembro de 2026