Servicio de validacion de identidad

Servicio de validacion de identidad - Chile

Para integrar el servicio de Servicio de validacion 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/identity-cl/"
payload = {'document_number': '8888888-1'}
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 = "{\"document_number\": \"8888888-1\"}"
RequestBody body = RequestBody.create(mediaType, payload);
Request request = new Request.Builder()
  .url("https://apitude.co/api/v1.0/requests/identity-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({"document_number": "8888888-1"});
var requestOptions = {
  method: 'POST',
  headers: myHeaders,
  body: raw,
  redirect: 'follow'
};
fetch("https://apitude.co/api/v1.0/requests/identity-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/identity-cl/"
method := "POST"
data := "{\"document_number\": \"8888888-1\"}"
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/identity-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/identity-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/identity-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/identity-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/identity-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": {
         "age": 58,
         "rut": "8888888-1",
         "name": "JHON WICK",
         "found": true,
         "deceased": false,
         "addresses": [
            {
               "city": "SANTIAGO",
               "date": "2023-01-04",
               "type": "BUSINESS",
               "address": "AV. ANDRES BELLO 2425",
               "commune": "SANTIAGO CENTRO"
            },
            {
               "city": "NY",
               "date": "1999-11-04",
               "type": "RESIDENTIAL",
               "address": "121 MILL NECK",
               "commune": "LONG ISLAND"
            }
         ],
         "date_of_birth": "1964-10-12",
         "phone_numbers": [
            {
               "type": "PERSONAL",
               "number": "5555555",
               "area_code": "02"
            },
            {
               "type": "PERSONAL",
               "number": "1946020",
               "area_code": "315"
            }
         ],
         "email_addresses": [
            "jhon.wick@gmail.com",
            "the_excommunicado@hotmail.com"
         ]
      },
      "error": "",
      "end_at": "2023-01-30 21:54:06.453355",
      "status": 200,
      "message": "successful",
      "queried_by": "YOUR-USER",
      "service_name": "identity-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á identity-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.age: La edad es un entero con la edad de la persona (número) denominada en años.
data.found: La variable es un booleano . Los valores posibles son:
- true : El código RUT se encuentra con información en la base de datos de personas.
- false : El código RUT no se encuentra con información en la base de datos de personas.
data.deceased: La variable es un booleano . Los valores posibles son:
- true : La persona dueña del código RUT ha fallecido.
- false : La persona dueña del código RUT se encuentra con vida.
data.addresses: La variable es una lista de objetos que representan una direccion previa del código RUT. La lista puede tener cero o más elementos. Los campos de un objeto son:
- data.addresses[1].city : La ciudad donde se reporta la dirección.
- data.addresses[1].date : La fecha en formato YYYY-MM-DD cuando se reportó la dirección.
- data.addresses[1].type : El tipo de dirección. Los valores posibles son: BUSINESS para direcciones comerciales y RESIDENTIAL para direcciones no comerciales.
- data.addresses[1].address : La dirección completa reportada.
- data.addresses[1].commune : La comuna donde se reporta la dirección.
data.date_of_birth: El fecha de nacimiento es una cadena con el formato YYYY-MM-DD.
data.phone_numbers: La variable es una lista de objetos que representan un número telefonico previo del código RUT. La lista puede tener cero o más elementos. Los campos de un objeto son:
- data.phone_numbers[1].area_code : El código de area dentro del pais reportado. Es una cadena
- data.phone_numbers[1].type : El tipo de dirección. Los valores posibles son: BUSINESS para direcciones comerciales y PERSONAL para direcciones no comerciales.
- data.phone_numbers[1].number : El número de telefono reportado. Es una cadena . Tipicamente, se debe concatenar código de area número de telefono para obtener el valor completo.
data.phone_numbers: La variable es una lista de objetos tipo cadena que representan un email previamente reportado para el código RUT.

Sobre este servicio

Este servicio permite obtener, a traves de API, la información de de validación de identidad que obtiene Apitude a traves de nuestra serie de partners afiliados. Esta API recibe un numero de RUT chileno y retorna la información requerida para validar los datos de un usuario, como por ejemplo las direcciones, los nombres, los emails y los numeros de telefono.

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

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

Get API Access

Servicios

Help and support

Pricing

Open Services APIs

Contract Required

Service Pipelines