Saltar al contingut principal
POST
Verifica les dades de la Cédula veneçolana amb els registres del cens electoral del CNE. Didit ofereix aquest servei a través de POST /v3/database-validation/ perquè pugueu verificar les dades enviades amb la font oficial i rebre resultats de coincidència normalitzats. Format d’entrada: document_number accepta la Cédula veneçolana (7-10 dígits, amb prefix V/E opcional).

Cobertura

  • Cobertura: 90-95%
  • País: Veneçuela
  • ID del servei: ven_cedula
  • Domini de dades: Identitat
  • Categoria: NationalIDRegistry

Entrades

  • Entrades obligatòries: document_number
  • Entrades opcionals: first_name, last_name, vendor_data
  • Consentiment: No cal
  • Disponibilitat en el flux de treball: Disponible en el flux de treball
  • Cobertura: 90-95%
  • Preu: $0.20 per consulta satisfactòria

Paràmetres del cos

string
predeterminat:"VEN"
requerit
Codi de país ISO 3166-1 alpha-3 per a aquest servei de base de dades.Exemple: VEN
string
predeterminat:"ven_cedula"
requerit
Llista que conté l’ID d’aquest servei. Fixar el servei manté la sol·licitud acotada a aquesta base de dades exacta.Exemple: ven_cedula
string
predeterminat:"V12345678"
requerit
Número de document extret d’un document o proporcionat per l’usuari.Exemple: V12345678
string
Nom de pila a validar.Exemple: John
string
Cognom a validar.Exemple: Doe
string
predeterminat:"user-1234"
La vostra referència estable d’usuari per a aquesta persona, com ara el vostre ID d’usuari intern. Didit l’utilitza per vincular les verificacions independents amb el mateix usuari final i reduir el soroll en la detecció de duplicats.Exemple: user-1234

Regles d’entrada i notes de validació

  • Cédula veneçolana (7-10 dígits, amb prefix V/E opcional)
  • document_number ha de tenir entre 7 i 12 caràcters.
  • document_number ha de coincidir amb [VvEe]?-?\d{7,10}.

Com fer la crida

Dades retornades

Els camps exactes que apareixen a source_data depenen del que retorni el registre. L’exemple generat per a ven_cedula documenta actualment aquesta estructura normalitzada:
  • document_type
  • first_name
  • full_name
  • identification_number
  • last_name

Preus i SLA

Veneçuela: les consultes de verificació de Cédula es facturen només quan Didit rep un resultat concloent de la font de validació.
  • Preu per crida: $0.20 USD.
  • Facturació: per consulta satisfactòria. No se us cobra quan el registre no és accessible, quan falten camps obligatoris o quan la sol·licitud es rebutja abans d’arribar a la font.
  • Latència: p95 típica inferior a 2 s.
  • Disponibilitat: 99.9% per trimestre per part de Didit; la disponibilitat de la font externa varia segons el país i el conjunt de dades.

Continua llegint

Darrera modificació el 7 de novembre del 2026