Version 1.0.0

Guía de Integración

Bienvenido al backend de consultas automatizadas del padrón. Esta documentación detalla los endpoints disponibles para extraer información demográfica y fotográfica de ciudadanos a partir de su documento de identidad.

Requisito de Autenticación: Esta API se encuentra protegida. Todas las peticiones HTTP deben incluir obligatoriamente la cabecera X-API-Key con su token validado.

Consultar Ciudadano

Recupera la información del padrón en tiempo real. Este endpoint omite mecanismos de validación frontend automatizando la extracción vía subprocesos.

POST /consultar-cedula

Parámetros de entrada (Body)

Campo	Tipo	Descripción
`cedula`	`string`	Documento de identidad de 11 dígitos numéricos sin guiones o con formato estándar.

Implementación

A continuación se muestra un ejemplo estándar utilizando JavaScript nativo (Fetch API):

const consultarDatos = async (cedula) => {
    const response = await fetch("https://api.tudominio.com/consultar-cedula", {
        method: "POST",
        headers: {
            "Content-Type": "application/json",
            "X-API-Key": "tu_clave_secreta_super_segura_123"
        },
        body: JSON.stringify({ cedula: cedula })
    });

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

    const json = await response.json();
    return json.data;
};

// Ejecución con registro de prueba
consultarDatos("40200000000").then(console.log);