Validación Biométrica de Documentos de Identidad

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

Lets integrate Validación Biométrica de Documentos de Identidad - Chile in your system. First, get your Apitude API key, then send a POST request to Apitude... And that's it!.

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))

That POST request should return the following


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

This response will contains a unique request ID that you should poll using a GET as follows


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))

How does the response looks like?


{
   "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, but what does each field in that JSON means?

The general parts:

message:The message is an Apitude generated string with an informational text about the request.
result:The result is contains the main part of the request.
result.error:The error is a string generated by apitude for the request if everything worked it will be blank.
result.message:The message is a string with two options successful or unsuccessful depending of how your request finished.
result.queried_by:The queried_by field is a string that lets you know what user started the request.
result.end_at:The end_at field is a string formatted date that lets you know at what time the request ended in Apitude.
result.service_name:The service_name field is a string that echos the service called. For this service it will always be document-id-cl.
result.status:The status field is a integer that represents whether the service returned data from the input sent in the request. It could be one of the following values:
- 200: The service returned response data for the payload that was sent in the creation of the request.
- 404: The service did not returned data for the payload that was sent in the creation of the request.
- 400: The service did not started because your input was invalid.
- 500: Apitude tried to execute your request, however the service Apitude uses to execute your request was down. Please wait some time and try again, Apitude will not charged you for requests with this code.
Depending on the service, you want it to return different codes. For example, if you are checking the user against a security list to whitelist the user you should look for a 404, because a 200 would mean the user is in fact in the list. Other cases however, like creating objects in the name of a user you want the code to be 200, since it will imply the creation was a success.

The data in the response:

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.

About this service

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

Who can you query using this service?:

This service (document-id-cl) is available for you to query individuals only.

Get API Access

Services

Help and support

Pricing

Open Services APIs

Contract Required

Service Pipelines

Biometric Validation