Validación Biométrica de Documentos de Identidad

Validación Biométrica de Documentos de Identidad - Chile

Para integrar el servicio de Validación Biométrica de Documentos de Identidad - Chile en su sistema. Primero, obtenga su API key de Apitude, luego envíe una solicitud POST a Aptitude ... ¡Y eso es todo!.

Get API Access


import requests
url = "https://apitude.co/api/v1.0/requests/document-id-cl/"
payload = {'qr_url': 'https://portal.sidiv.registrocivil.cl/docstatus?RUN=11562208-3&type=CEDULA&serial=1045359418&mrz=109959411110002611217', 'back_img': 'https://apitude.co/example/not/real/url/back_cedula.jpg', 'front_img': 'https://apitude.co/example/not/real/url/front_picture.jpg'}
headers = {
    'x-api-key': 'API-KEY',
    'Content-Type': 'application/json'
}
response = requests.post(url, headers=headers, data=payload)
print(response.json())


OkHttpClient client = new OkHttpClient().newBuilder().build();
MediaType mediaType = MediaType.parse("application/json");
String payload = "{\"qr_url\": \"https://portal.sidiv.registrocivil.cl/docstatus?RUN=11562208-3&type=CEDULA&serial=1045359418&mrz=109959411110002611217\", \"front_img\": \"https://apitude.co/example/not/real/url/front_picture.jpg\", \"back_img\": \"https://apitude.co/example/not/real/url/back_cedula.jpg\"}"
RequestBody body = RequestBody.create(mediaType, payload);
Request request = new Request.Builder()
  .url("https://apitude.co/api/v1.0/requests/document-id-cl/")
  .method("POST", body)
  .addHeader("x-api-key", "API-KEY")
  .addHeader("Content-Type", "application/json")
  .build();
Response response = client.newCall(request).execute();


var myHeaders = new Headers();
myHeaders.append("x-api-key", "API-KEY");
myHeaders.append("Content-Type", "application/json");
var raw = JSON.stringify({"qr_url": "https://portal.sidiv.registrocivil.cl/docstatus?RUN=11562208-3&type=CEDULA&serial=1045359418&mrz=109959411110002611217", "front_img": "https://apitude.co/example/not/real/url/front_picture.jpg", "back_img": "https://apitude.co/example/not/real/url/back_cedula.jpg"});
var requestOptions = {
  method: 'POST',
  headers: myHeaders,
  body: raw,
  redirect: 'follow'
};
fetch("https://apitude.co/api/v1.0/requests/document-id-cl/", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));


url := "https://apitude.co/api/v1.0/requests/document-id-cl/"
method := "POST"
data := "{\"qr_url\": \"https://portal.sidiv.registrocivil.cl/docstatus?RUN=11562208-3&type=CEDULA&serial=1045359418&mrz=109959411110002611217\", \"front_img\": \"https://apitude.co/example/not/real/url/front_picture.jpg\", \"back_img\": \"https://apitude.co/example/not/real/url/back_cedula.jpg\"}"
payload := strings.NewReader(data)
client := &http.Client {}
req, err := http.NewRequest(method, url, payload)
if err != nil {
    fmt.Println(err)
}
req.Header.Add("x-api-key", "API-KEY")
req.Header.Add("Content-Type", "application/json")
res, err := client.Do(req)
defer res.Body.Close()
body, err := ioutil.ReadAll(res.Body)
fmt.Println(string(body))

Alternatively, the service also receives the following payload

En este caso, en lugar de URLs, también puedes enviar las imágenes en la petición misma, codificadas como cadenas en base64. Adicionalmente, el campo qr_url es opcional entonces puedes no enviarlo.

Ejemplo de Una Cedula Chilena


import requests
url = "https://apitude.co/api/v1.0/requests/document-id-cl/"
payload = {'back_img': '/9j/4AAQSkZJR...YOUR IMAGE ENCODED IN BASE64...H/9k=', 'front_img': '/9j/4AAQSkZJR...YOUR IMAGE ENCODED IN BASE64...H/9k='}
headers = {
    'x-api-key': 'API-KEY',
    'Content-Type': 'application/json'
}
response = requests.post(url, headers=headers, data=payload)
print(response.json())


OkHttpClient client = new OkHttpClient().newBuilder().build();
MediaType mediaType = MediaType.parse("application/json");
String payload = "{\"front_img\": \"/9j/4AAQSkZJR...YOUR IMAGE ENCODED IN BASE64...H/9k=\", \"back_img\": \"/9j/4AAQSkZJR...YOUR IMAGE ENCODEDIN BASE64...H/9k=\"}"
RequestBody body = RequestBody.create(mediaType, payload);
Request request = new Request.Builder()
  .url("https://apitude.co/api/v1.0/requests/document-id-cl/")
  .method("POST", body)
  .addHeader("x-api-key", "API-KEY")
  .addHeader("Content-Type", "application/json")
  .build();
Response response = client.newCall(request).execute();


var myHeaders = new Headers();
myHeaders.append("x-api-key", "API-KEY");
myHeaders.append("Content-Type", "application/json");
var raw = JSON.stringify({"front_img": "/9j/4AAQSkZJR...YOUR IMAGE ENCODED IN BASE64...H/9k=", "back_img": "/9j/4AAQSkZJR...YOUR IMAGE ENCODEDIN BASE64...H/9k="});
var requestOptions = {
  method: 'POST',
  headers: myHeaders,
  body: raw,
  redirect: 'follow'
};
fetch("https://apitude.co/api/v1.0/requests/document-id-cl/", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));


url := "https://apitude.co/api/v1.0/requests/document-id-cl/"
method := "POST"
data := "{\"front_img\": \"/9j/4AAQSkZJR...YOUR IMAGE ENCODED IN BASE64...H/9k=\", \"back_img\": \"/9j/4AAQSkZJR...YOUR IMAGE ENCODEDIN BASE64...H/9k=\"}"
payload := strings.NewReader(data)
client := &http.Client {}
req, err := http.NewRequest(method, url, payload)
if err != nil {
    fmt.Println(err)
}
req.Header.Add("x-api-key", "API-KEY")
req.Header.Add("Content-Type", "application/json")
res, err := client.Do(req)
defer res.Body.Close()
body, err := ioutil.ReadAll(res.Body)
fmt.Println(string(body))

Esa solicitud POST debe devolver lo siguiente


{
    "message": "Request processed successfully",
    "url": "/api/v1.0/requests/document-id-cl/e0606c19-a32d-410f-b2eb-d57a665677bc/",
    "request_id": "e0606c19-a32d-410f-b2eb-d57a665677bc"
}

Esta respuesta contendrá un ID de solicitud único que debe utilizar enviando un GET de la siguiente manera


import requests
url = "https://apitude.co/api/v1.0/requests/document-id-cl/e0606c19-a32d-410f-b2eb-d57a665677bc/"
headers = {
    'x-api-key': 'API-KEY',
    'Content-Type': 'application/json'
}
response = requests.get(url, headers=headers)
print(response.json())


OkHttpClient client = new OkHttpClient().newBuilder().build();
MediaType mediaType = MediaType.parse("application/json");
Request request = new Request.Builder()
  .url("https://apitude.co/api/v1.0/requests/document-id-cl/e0606c19-a32d-410f-b2eb-d57a665677bc/")
  .method("GET")
  .addHeader("x-api-key", "API-KEY")
  .addHeader("Content-Type", "application/json")
  .build();
Response response = client.newCall(request).execute();


var myHeaders = new Headers();
myHeaders.append("x-api-key", "API-KEY");
myHeaders.append("Content-Type", "application/json");
var requestOptions = {
  method: 'GET',
  headers: myHeaders,
  redirect: 'follow'
};
fetch("https://apitude.co/api/v1.0/requests/document-id-cl/e0606c19-a32d-410f-b2eb-d57a665677bc/", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));


url := "https://apitude.co/api/v1.0/requests/document-id-cl/e0606c19-a32d-410f-b2eb-d57a665677bc/"
method := "GET"
client := &http.Client {}
req, err := http.NewRequest(method, url)
if err != nil {
    fmt.Println(err)
}
req.Header.Add("x-api-key", "API-KEY")
req.Header.Add("Content-Type", "application/json")
res, err := client.Do(req)
defer res.Body.Close()
body, err := ioutil.ReadAll(res.Body)
fmt.Println(string(body))

¿Cómo se ve la respuesta?


{
   "result": {
      "data": {
         "face_id": true,
         "security": {
            "error": "",
            "fraud": false,
            "probability": 1.0
         },
         "back_info": {
            "run": "11562208-3",
            "sex": "M",
            "name": "JHON BOB",
            "error": "",
            "valid": true,
            "serial": "1045359418",
            "last_name": "ROSS WADE",
            "birth_date": "1986-11-21",
            "profession": "ABOGADO",
            "expiry_date": "2026-11-21",
            "nationality": "CHILE",
            "document_type": "IN",
            "optional_data": "S13",
            "place_of_birth": "VALDIVIA",
            "issuing_country": "CHILE"
         },
         "front_info": {
            "name": "JHON BOB",
            "last_name": "ROSS WADE",
            "issuing_date": "2005-12-01",
            "status_registro_civil": "VIGENTE"
         }
      },
      "error": "",
      "end_at": "2022-12-13 23:26:25.645144",
      "status": 200,
      "message": "successful",
      "queried_by": "AnonymousUser",
      "service_name": "document-id-cl"
   },
   "message": "Request completed"
}

Ok, pero ¿qué significa cada campo en ese JSON?

Las partes generales:

message:El mensaje es un string generado por Aptitude con un texto informativo sobre la solicitud..
result:El resultado contiene la parte principal de la solicitud..
result.error:El error es un string generado por Aptitude para la solicitud. Si todo funcionó, estará en blanco.
result.message:El mensaje es un string con dos opciones successful o unsuccessful dependiendo de cómo terminó su solicitud.
result.queried_by:El campo queried_by es un string que indica que usuario creo la solicitud.
result.end_at:El campo end_at es un string formatted date que indica en qué momento la solicitud terminó en Apitude.
result.service_name:El campo service_name es un string que retorna el servicio llamado. Para este servicio siempre será document-id-cl.
result.status:El campo estado, es un entero cuyo valor representa si el servicio retorno informacion para la solicitud enviada. Puede tomar alguno de los siguientes valores:
- 200: El servicio devolvió datos con la respuesta para la información que se envió en la solicitud.
- 404: El servicio no devolvió datos con la respuesta para la información que se envió en la solicitud.
- 400: El servicio no se inició porque su entrada no era válida.
- 500: Apitude intentó ejecutar tu solicitud, sin embargo, el servicio que utiliza Apitude para ejecutar su solicitud no funciona. Espera un poco y vuelve a intentarlo, Apitude no te cobrará solicitudes con este código.
Dependiendo del servicio, quieres que devuelva diferente códigos. Por ejemplo, si está pasando al usuario por un proceso de vinculación y desea que este quede en su lista blanca, debe buscar un 404, porque un200 significaría que el usuario está de hecho en la lista. Otros casossin embargo, como crear objetos con el nombre de un usuario, desea que el código sea200, ya que implicará que la creación fue un éxito.

Los datos en la respuesta:

data.back_info: Este campo es un diccionario con la información OCR de la cara posterior (código de barras) de la imagen de identificación nacional chilena enviada.
data.front_info: Este campo es un diccionario con la información OCR de la cara frontal de la imagen de identificación nacional chilena enviada.
data.front_info.last_name: Este campo es un string. El campo presenta el apellido del usuario como se encuentra en el documento de identidad. Para obtener este campo, el API REST utiliza un proceso de OCR.
data.front_info.name: Este campo es un string. El campo presenta el nombre del usuario como se encuentra en el documento de identidad. Para obtener este campo, el API REST utiliza un proceso de OCR.
data.front_info.issuing_date: Este campo es un string. El campo presenta la fecha de emisión del documento de identidad del usuario como se encuentra en el documento de identidad. Para obtener este campo, el API REST utiliza un proceso de OCR. El formato de la fecha es: YYYY-MM-DD
data.front_info.status_registro_civil: Este campo es un string. Un valor de VIGENTE significaría que la cedula del cliente fue verificada exitosamente contra el Registro Civil de Chile y que este documento de identidad se encuentra en estado activo y sin novedades negativas reportado. Un estado distinto a VIGENTE significaría que la cedula tiene alguna novedad y alta probabilidad de ser fraude.
data.back_info.valid: Este campo es un booleano. Un valor de verdadero significaría que el codigo de barras MRZ dentro de la cara posterior de la cedula es correcto y que la información presente en este fue validada de forma exitosa. Un valor de falso en este campo significaría lo contrario. Si el campo es marcado como falso es muy probable que el documento haya expirado o haya sido adulterado.
data.back_info.last_name: Este campo es un string. El campo presenta el apellido del usuario como se encuentra en el codigo de barras MRZ del documento de identidad.
data.back_info.name: Este campo es un string. El campo presenta el nombre del usuario como se encuentra en el codigo de barras MRZ del documento de identidad.
data.back_info.issuing_country: Este campo es un string. El campo presenta el pais de expedicion de la cedula del usuario como se encuentra en el codigo de barras MRZ del documento de identidad.
data.back_info.nationality: Este campo es un string. El campo presenta el pais de nacionalidad del usuario como se encuentra en el codigo de barras MRZ del documento de identidad.
data.back_info.birth_date: Este campo es un string. El campo presenta la fecha de nacimiento del usuario como se encuentra en el codigo de barras MRZ del documento de identidad. El formato de la fecha es: YYYY-MM-DD
data.back_info.expiry_date: Este campo es un string. El campo presenta la fecha de expiración del documento de identidad del usuario como se encuentra en el codigo de barras MRZ. El formato de la fecha es: YYYY-MM-DD
data.back_info.sex: Este campo es un string. El campo presenta el sexo al momento de nacimiento del usuario como se encuentra en el codigo de barras MRZ del documento de identidad. Las dos opciones posibles son M y F
data.back_info.run: Este campo es un string. El campo presenta el numero de identificación del documento de identidad del usuario como se encuentra en el codigo de barras MRZ. Se incluye el digito de verificación.
data.back_info.serial: Este campo es un string. El campo presenta el numero unico de verificación del documento de identidad del usuario como se encuentra en el codigo de barras MRZ. Este campo es utilizado para la validación de la cedula contra el Registro Civil de Chile.
data.back_info.profession: Este campo es un string. El campo presenta la profesión del usuario. Este campo requiere que el usuario este en posesión de un titulo profesional otorgado por alguna universidad, instituto profesional u otro organismo autorizado para ello.
data.back_info.place_of_birth: Este campo es un string. El campo presenta lugar de nacimeinto del usuario. Usando este campo y el campo data.back_info.nationality se puede idenficar exactamente el lugar de nacimiento del usuario en Chile o internacionalmente.
data.face_id Este campo es un booleano con un valor de verdadero si los campos data.back_info, data.front_info y data.security son todos verdaderos, un valor de falso significaría lo contrario.

Sobre este servicio

El servicio permite validar una cedula Chilena por medio de un API REST. El servicio recibe como parametros de entrada una foto de la parte frontal de la cedula Chilena (lado de la imagen y nombre), una foto posterior de la cedula Chilena (lado del codigo de barras) y (De forma opcional) la URL contenida en el codigo QR del lado posterior de cedula. El servicio realiza las siguientes validaciones:

Las imagenes pertenecen a una cedula chilena.
Las imagenes no han sido adulteradas de manera fisica o digital.
La imagen frontal contiene la cara de solamente una persona.
La cedula se encuentra activa en el Registro Nacional Civil de Chile

El servicio retorna en su respuesta:

Si las imagenes de la cedula son validas o no
Si las imagenes de la cedula han sido adulteradas o no
Si la cedula se encuentra activa y valida en el Registro Nacional Civil de Chile o no
La información en formato JSON del lado frontal de la cedula
La información en formato JSON del lado posterior de la cedula
La información en formato JSON de la cedula en el Registro Nacional Civil de Chile

¿A quién puede consultar utilizando este servicio?:

Este servicio (document-id-cl) está disponible para consultar unicamente individuos.

Get API Access

Servicios

Help and support

Pricing

Open Services APIs

Contract Required

Service Pipelines