Qué devuelve una consulta de DNI
La respuesta normalizada utiliza documento, nombres, apellido_paterno y apellido_materno. Los campos pueden faltar o ser nulos según la información disponible en la fuente. Trata esa ausencia como parte del flujo: permite que la persona revise y complete sus datos antes de guardar el registro.
El DNI se envía como texto, aunque contenga únicamente números. Así conservas cualquier cero inicial y evitas conversiones distintas entre tu formulario, el servidor y la base de datos. La API valida la longitud y el patrón antes de consultar al proveedor.
Cómo integrar la API DNI en un registro
Crea tu cuenta, verifica tu correo y genera una API Key en el dashboard. Desde tu servidor, envía POST /api/v1/dni con Content-Type: application/json y Authorization: Bearer seguido de tu clave. El cuerpo contiene un único campo: dni.
En un formulario HTML, el navegador debe llamar a una ruta de tu propio backend. Esa ruta valida la sesión, comprueba los ocho dígitos y añade el token antes de comunicarse con DatosPerú. La guía HTML incluye el formulario y un ejemplo de proxy en Node.js. Nunca insertes la clave en el JavaScript público ni en la URL.
Una consulta no reemplaza la verificación de una persona
Encontrar un nombre asociado a un documento no demuestra que quien completa el formulario sea su titular. Si tu proceso necesita comprobar identidad, combina el resultado con los controles y autorizaciones adecuados para ese proceso.
DatosPerú es un servicio privado que utiliza JSON.pe como proveedor. No presentamos esta integración como una API oficial de RENIEC, ni prometemos fotografías, biometría, dirección personal o datos de menores. Consulta únicamente información que estés autorizado a tratar.
Créditos y manejo de errores
Una respuesta exitosa consume un crédito. El plan Gratis incluye 100 créditos por cada periodo de 30 días; Pro ofrece 70 000 créditos mensuales por S/29 e Ilimitado cuesta S/99 al mes. Cada plan conserva un límite de solicitudes por minuto.
Distingue un parámetro inválido (422), una clave no válida (401), un resultado no encontrado (404) y un límite alcanzado (429). Un fallo de la fuente no debe rellenar tu formulario con valores inventados. Muestra un estado de error y ofrece continuar mediante una revisión manual.
Preguntas frecuentes
¿La API DNI es gratis?
Existe un plan Gratis con 100 créditos cada 30 días y acceso a los endpoints de consulta. Se requiere cuenta verificada y API Key.
¿Es una API oficial de RENIEC?
No. DatosPerú es un servicio independiente y consulta a su proveedor JSON.pe.
¿Puedo usar la API desde HTML?
Sí, a través de tu servidor. El ejemplo descargable mantiene el token fuera del navegador.