CedulaVE API

CedulaVE API es un script escrito en PHP para consultar datos personales de habitantes de Venezuela inscritos en el CNE mediante su Cdula de Identidad.

Contibucin

Contribuciones, problemas y solicitudes de funciones son bienvenidos. Sintase libre de consultar los issues si quieres contribuir.

💽 Instalacin

La forma ms fcil de instalar CedulaVE API es a travs de Composer

composer require megacreativo/cedulave-api

📜 Ejemplo PHP

El mtodo info est disponible para ejecutar la consula, las respuesta se obtiene por defecto en formato JSON

Consultar la API

Para ver ms ejemplos valla a examples

/**
 * Estructura de parametros
 * 
 * @param string   $nac     Tipo de Nacionalidad. Valores permitidos [V|E]. Cualquier otro valor producir un Error 301
 * @param string   $cedula  Nmero de Cdula de Identidad a consultar
 * @param boolean  $json    (Opcional) Si es true devolver JSON como respuesta, en caso contrario devuelve un ARRAY. Valor por defecto TRUE
 * @param boolean  $pretty  (Opcional) Se devuelve un JSON, este parametro establece si se aplica JSON_PRETTY_PRINT. Valor por defecto FALSE
 */
function info(string $nac, string $cedula, bool $json = true, bool $pretty = false)


/**
 * Ejemplos de uso
 **/
// Retorna un JSON
CedulaVE::info('V', '12345678');

// Retorna un Array
CedulaVE::info('V', '12345678', false);

// Retorna un JSON formateado 
vCedulaVE::info('V', '12345678', true, true);

Respuesta exitosa

{
    "status": 200,
    "version": "1.1.1",
    "website": "https://api.megacreativo.com/public/cedula-ve/v1",
    "response":
    {
        "nac": "V", /* Nacionalidad. [V|E] */
        "dni": "12345678", /* Cdula de identidad */
        "name": "Jhon Alfred", /* Primer y segundo nombre */
        "lastname": "Doe Law", /* Primer y segundo apellido */
        "fullname": "Jhon Alfred Doe Law", /* Nombre completo */
        "state": "Estado", /* Estado donde se encuentra el Centro de votacin */
        "municipality": "Municipio", /* Municipio del Centro de votacin */
        "parish": "Parroquia", /* Parroquia del Centro de votacin */
        "voting": "Centro de votacin", /* Nombre del Centro de votacin */     
        "address": "Direccion" /* Direccin del Centro de votacin */
    }
}

Array
(
    [status] => 200
    [version] => 1.1.1
    [api] => https://api.megacreativo.com/public/cedula-ve/v1
    [data] => Array
        (
            [nac] => V
            [dni] => 12345678
            [name] => JHON ALFRED
            [lastname] => DOE LAW
            [fullname] => JHON ALFRED DOE LAW
            [state] => ESTADO
            [municipality] => MUNICIPIO
            [parish] => PARROQUIA
            [voting] => CENTRO DE VOTACION
            [address] => DIRECCION DEL CENTRO
        )

)

Respuestas de error

Error 404 La cdula consultada no est inscrita en el CNE

{
    "status": 404,
    "version": "1.1.1",
    "api": "https://api.megacreativo.com/public/cedula-ve/v1",
    "data": {
        "code": 404,
        "message": "No se encontr la cdula de identidad"
    }
}

Error 301 Los datos recibidos no son correctos, Error en la nacionalidad. Valores permitidos [V|E]

{
    "status": 301,
    "version": "1.1.1",
    "api": "https://api.megacreativo.com/public/cedula-ve/v1",
    "data": {
        "code": 301,
        "message": "Los datos recibidos no son correctos, Error en la nacionalidad. Valores permitidos [V|E]"
    }
}

Error 302 Los datos recibidos no son correctos. Se introdujo un caracter no numerico

{
    "status": 302,
    "version": "1.1.1",
    "api": "https://api.megacreativo.com/public/cedula-ve/v1",
    "data": {
        "code": 302,
        "message": "Los datos recibidos no son correctos. Se introdujo un caracter no numerico"
    }
}

Error 303 Los datos recibidos no son correctos. Se introdujo un caracter no numerico

{
    "status": 303,
    "version": "1.1.1",
    "api": "https://api.megacreativo.com/public/cedula-ve/v1",
    "data": {
        "code": 303,
        "message": "Debe ingresar una cedula de indetidad vlida. Slo se permiten caracteres numricos"
    }
}