Integrar API DNI con JavaScript — Tutorial paso a paso

Requisitos

• Cuenta en JSON.pe con token Bearer
• Node.js 18+ o navegador moderno con fetch

Código completo

async function consultarDNI(dni) {
  const response = await fetch("https://api.json.pe/api/dni", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.JSONPE_TOKEN}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ dni }),
  });

  if (!response.ok) throw new Error(`HTTP ${response.status}`);
  return response.json();
}

// Uso
const resultado = await consultarDNI("27427864");
console.log(resultado.data.nombre_completo);

Respuesta esperada

{
  "success": true,
  "data": {
    "numero": "27427864",
    "nombres": "JOSE PEDRO",
    "apellido_paterno": "CASTILLO",
    "apellido_materno": "TERRONES",
    "codigo_verificacion": 7
  }
}

Tips

• Usa variables de entorno para el token.
• Valida formato de DNI (8 dígitos) antes de consultar.
• Más ejemplos en /api-dni.