Consulta DNI
Este endpoint le permite obtener la información de una persona ingresando su número de DNI.
Consideraciones
- Este servicio no se conecta con RENIEC
- Los datos obtenidos se obtienen del padrón reducido de SUNAT y otras fuentes públicas.
- Las consultas de DNI son simples, mostrando únicamente número de dni, nombre y apellidos.
- El padrón reducido SUNAT no devuelve datos de menores de edad, dirección, fecha nacimiento, sexo.
- En algunos casos no se obtendrá resultado de la consulta debido a la información de las fuentes públicas, esto no debe considerarse como falla o error del servicio.
- Los datos del padron reducido de SUNAT son actualizados diariamente a las 3:00 AM, el procesamiento de datos demora aproximadamente 15 minutos.
- Las peticiónes de DNI's se almacenan en cache durante 24 horas.
GET
https://api.perufacturacion.com/api
| Accept | application/json |
| Content-Type | application/json |
| api_token | API Token |
| json | Para consulta de DNI establecer este valor en "dni" |
| id | Número de DNI
|
Ejemplos de uso
Asumimos que usted sabe cómo hacer solicitudes API en el lenguaje de programación elegido para su aplicativo. Hemos incluido algunos ejemplos simples en algunos lenguajes de programación.
Esta API funciona con distintos lenguajes de programación como C#, JavaScript, Python, PHP, Go, Java, Ruby, Visual Basic, también se puede integrar con Excel y Access.
Ejemplo de uso en PHP:
$curl = curl_init();
curl_setopt_array($curl, array(CURLOPT_URL => "https://api.perufacturacion.com/api?api_token={SU_API_TOKEN}&json=dni&id={DNI}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_SSL_VERIFYPEER => false
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
Success Response:
{
"dni": "00000001",
"cliente": "PEREZ RODRIGUEZ JORGE",
"nombres": "JORGE",
"apellido_paterno": "PEREZ",
"apellido_materno": "RODRIGUEZ",
"mensaje": "OK",
"code": "200"
}
Failed:
Si no se han encontrado resultados:
{
"mensaje": "No encontrado",
"code": "404"
}
Si ha excedido el limite de consultas diario /mensual:
{
"mensaje": "quota limit exceeded (daily/monthly) or token invalid",
"code": "503"
}
Si no ha enviado uno de los parametros a la endpoint:
{
"mensaje": "Empty parameters are not allowed ('json' or 'api_token' or 'id')",
"code": "503"
}