Vai al contenuto principale
POST
Verifica lo stato migratorio e l’identità di uno straniero rispetto ai registri governativi di Migración Colombia (cédula de extranjería). Didit espone questo servizio tramite POST /v3/database-validation/, così puoi verificare i dati inviati rispetto alla fonte autorevole e ricevere risultati di corrispondenza normalizzati. Formato dell’input: personal_number accetta la Cédula colombiana (6-10 cifre).

Copertura

  • Copertura: —
  • Paese: Colombia
  • ID servizio: col_migracion
  • Dominio dati: Identità
  • Categoria: ResidencePermit

Input

  • Input obbligatori: personal_number, date_of_birth, nationality
  • Input facoltativi: first_name, last_name, vendor_data
  • Consenso: non richiesto
  • Disponibilità nel workflow: disponibile nel workflow
  • Copertura: —
  • Prezzo: $1.20 per interrogazione riuscita

Parametri del body

string
predefinito:"COL"
obbligatorio
Codice paese ISO 3166-1 alpha-3 per questo servizio di database.Esempio: COL
string
predefinito:"col_migracion"
obbligatorio
Array che contiene questo ID servizio. Vincolare il servizio mantiene la richiesta limitata a questo database specifico.Esempio: col_migracion
string
predefinito:"111111"
obbligatorio
Numero di identità personale specifico del paese.Esempio: 111111
string
predefinito:"1990-01-01"
obbligatorio
Data di nascita nel formato YYYY-MM-DD.Esempio: 1990-01-01
string
predefinito:"MEX"
obbligatorio
Valore nationality richiesto da questo servizio di database.Esempio: MEX
string
Nome da validare.Esempio: John
string
Cognome da validare.Esempio: Doe
string
predefinito:"user-1234"
Il tuo riferimento utente stabile per questa persona, come il tuo ID utente interno. Didit lo usa per collegare le verifiche autonome allo stesso utente finale e ridurre il rumore nel rilevamento dei duplicati.Esempio: user-1234

Regole di input e note di validazione

  • Cédula colombiana (da 6 a 10 cifre)
  • personal_number deve contenere solo cifre; rimuovi spazi, trattini e punteggiatura prima di inviare la richiesta.
  • personal_number deve essere lungo da 6 a 10 caratteri.

Come effettuare la chiamata

Dati restituiti

I campi esatti restituiti in source_data dipendono da ciò che il registro restituisce. L’esempio generato per col_migracion documenta attualmente questa struttura normalizzata:
  • first_name
  • identification_number
  • last_name

Prezzi e SLA

Colombia: le interrogazioni sullo stato migratorio degli stranieri effettuate tramite Migración Colombia vengono fatturate solo quando Didit riceve un risultato conclusivo dalla fonte di validazione.
  • Prezzo per chiamata: $1.20 USD.
  • Fatturazione: per interrogazione riuscita. Non ti viene addebitato nulla quando il registro non è raggiungibile, quando mancano campi obbligatori o quando la richiesta viene respinta prima di raggiungere la fonte.
  • Latenza: p95 tipico < 2 s.
  • Disponibilità: 99.9% per trimestre lato Didit; la disponibilità della fonte sottostante varia in base al paese e al dataset.

Continua la lettura

Ultima modifica il 7 novembre 2026