Saltar al contenido principal
POST
Devuelve los números de teléfono, correos electrónicos y direcciones conocidos vinculados a una persona física sudafricana. Didit ofrece este servicio a través de POST /v3/database-validation/ para que puedas verificar los datos enviados con la fuente oficial y recibir resultados de coincidencia normalizados.

Cobertura

  • Cobertura: —
  • País: Sudáfrica
  • ID del servicio: zaf_contactability
  • Dominio de datos: Telecomunicaciones
  • Categoría: Telecomunicaciones

Datos de entrada

  • Datos de entrada obligatorios: national_id
  • Datos de entrada opcionales: vendor_data
  • Consentimiento: Obligatorio
  • Disponibilidad en flujos: Disponible en el flujo de trabajo
  • Cobertura: —
  • Precio: $0.35 por consulta exitosa

Parámetros del cuerpo

string
predeterminado:"ZAF"
requerido
Código de país ISO 3166-1 alfa-3 de este servicio de base de datos.Ejemplo: ZAF
string
predeterminado:"zaf_contactability"
requerido
Array que contiene el ID de este servicio. Fijar el servicio limita la solicitud a esta base de datos concreta.Ejemplo: zaf_contactability
Consentimiento explícito del usuario final para este servicio.Ejemplo: true
string
predeterminado:"SAMPLE-NID-12345"
requerido
Número de identidad nacional para este servicio.Ejemplo: SAMPLE-NID-12345
string
predeterminado:"user-1234"
Tu referencia estable de usuario para esta persona, como tu ID de usuario interno. Didit la usa para vincular las comprobaciones independientes al mismo usuario final y reducir el ruido en la detección de duplicados.Ejemplo: user-1234

Reglas de entrada y notas de validación

  • Envía los campos indicados arriba exactamente como se obtuvieron del usuario o del documento.
  • Didit valida los campos obligatorios antes de consultar la base de datos. Las solicitudes rechazadas antes de la consulta a la fuente no se cobran.

Cómo invocarlo

Datos devueltos

Los campos exactos que aparecen en source_data dependen de lo que devuelva el registro. El ejemplo generado para zaf_contactability documenta actualmente esta estructura normalizada:
  • contact_email
  • contact_phone_numbers
  • date_of_birth
  • deceased
  • first_name
  • gender
  • identification_number
  • last_name
  • phone_history_count

Precios y SLA

Las consultas de Sudáfrica - Consulta de contactabilidad solo se facturan cuando Didit recibe un resultado concluyente de la fuente de validación.
  • Precio por consulta: $0.35 USD.
  • Facturación: por consulta exitosa. No se te cobra cuando el registro no está disponible, cuando faltan campos obligatorios o cuando la solicitud se rechaza antes de llegar a la fuente.
  • Latencia: p95 habitual < 2 s.
  • Disponibilidad: 99.9% por trimestre por parte de Didit; la disponibilidad de la fuente externa varía según el país y el conjunto de datos.

Sigue leyendo

Última modificación el 1 de noviembre de 2026