Saltar al contingut principal
POST
Verifica l’estat migratori i la identitat d’un estranger amb els registres oficials de Migración Colombia (cèdula d’estrangeria). Didit ofereix aquest servei a través de POST /v3/database-validation/ perquè puguis verificar les dades enviades amb la font oficial i rebre resultats de coincidència normalitzats. Format d’entrada: personal_number accepta la cèdula colombiana (6-10 dígits).

Cobertura

  • Cobertura: —
  • País: Colòmbia
  • ID del servei: col_migracion
  • Domini de dades: Identitat
  • Categoria: ResidencePermit

Entrades

  • Entrades obligatòries: personal_number, date_of_birth, nationality
  • Entrades opcionals: first_name, last_name, vendor_data
  • Consentiment: No cal
  • Disponibilitat en el flux de treball: Disponible en el flux de treball
  • Cobertura: —
  • Preu: $1.20 per consulta satisfactòria

Paràmetres del cos

string
predeterminat:"COL"
requerit
Codi de país ISO 3166-1 alpha-3 per a aquest servei de bases de dades.Exemple: COL
string
predeterminat:"col_migracion"
requerit
Matriu que conté l’ID d’aquest servei. Fixar el servei limita la sol·licitud a aquesta base de dades concreta.Exemple: col_migracion
string
predeterminat:"111111"
requerit
Número d’identitat personal específic del país.Exemple: 111111
string
predeterminat:"1990-01-01"
requerit
Data de naixement en format YYYY-MM-DD.Exemple: 1990-01-01
string
predeterminat:"MEX"
requerit
Valor de nationality que requereix aquest servei de bases de dades.Exemple: MEX
string
Nom de pila a validar.Exemple: John
string
Cognom a validar.Exemple: Doe
string
predeterminat:"user-1234"
La teva referència estable d’usuari per a aquesta persona, com ara el teu ID d’usuari intern. Didit l’utilitza per vincular les comprovacions independents al mateix usuari final i reduir el soroll de la detecció de duplicats.Exemple: user-1234

Regles d’entrada i notes de validació

  • Cèdula colombiana (6-10 dígits)
  • personal_number ha de contenir només dígits; elimina els espais, els guions i els signes de puntuació abans d’enviar la sol·licitud.
  • personal_number ha de tenir entre 6 i 10 caràcters.

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 col_migracion documenta actualment aquesta estructura normalitzada:
  • first_name
  • identification_number
  • last_name

Preus i SLA

Colòmbia: les consultes sobre l’estat migratori d’estrangers de Migración Colombia es facturen només quan Didit rep un resultat concloent de la font de validació.
  • Preu per crida: $1.20 USD.
  • Facturació: per consulta satisfactòria. No se’t factura 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ípic < 2 s.
  • Disponibilitat: 99.9% per trimestre per part de Didit; la disponibilitat de la font de dades varia segons el país i el conjunt de dades.

Continua llegint

Darrera modificació el 7 de novembre del 2026