Pular para o conteúdo principal
POST
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

  • 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
Em um fluxo, 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: ZAF
string
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_ownership
string
padrão:"SAMPLE-NID-12345"
obrigatório
Número de identidade nacional para este serviço.Exemplo: SAMPLE-NID-12345
string
padrão:"VRN123456"
obrigatório
Valor de vehicle_register_number exigido por este serviço de banco de dados.Exemplo: VRN123456
string
padrão:"ABC123GP"
obrigatório
Valor de vehicle_licence_plate exigido por este serviço de banco de dados.Exemplo: ABC123GP
string
padrão:"1HGCM82633A004352"
obrigatório
Valor de vin exigido por este serviço de banco de dados.Exemplo: 1HGCM82633A004352
string
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-1234

Regras 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

Dados retornados

Os campos exatos exibidos em source_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